Files
Forge-Engine/screens/labels/background_library.py
T
williamandClaude Sonnet 5 9199897784
Build and deploy / test-python (push) Successful in 6m26s
Build and deploy / test-js (push) Successful in 57s
Build and deploy / build-and-push (push) Skipped
Build and deploy / deploy (push) Skipped
Image de fond de scène + caméra qui suit le personnage, fps d'animation cohérent
Trois retours utilisateur :
- fps d'idle/interagir/touches supplémentaires alignés sur celui de la
  marche (8 i/s partout, était 4 pour idle — perçu comme "les autres
  animations sont lentes à côté de la marche").
- Nouveau menu "🏞️ Images de fond" dans "Objets de cette scène" : pose
  un objet kind="fond" à la taille RÉELLE de l'image choisie (pack
  CraftPix intégré en galerie, admin seulement — licence, voir
  core/sprite_gate.py), derrière tout le reste, insensible au clic.
- Si ce fond dépasse la scène, elle devient le "monde" : .playScreen.
  playScene est désormais le viewport (overflow:hidden, taille fixe),
  .sceneWorld le monde à l'intérieur — la caméra centre le premier
  personnage trouvé, bornée pour ne jamais montrer au-delà des bords
  (voir personnage-controller.js::forgeUpdateSceneCamera). Le personnage
  peut désormais se déplacer sur tout le monde, pas seulement le petit
  cadre visible (clampSceneObjectPosition, actions.js). Un jeu sans fond
  XXL garde un comportement strictement identique à avant (monde ==
  scène, transform vide).

Bibliothèque générée une fois par scripts/generate_background_manifest.py
(assets/background/, non versionné, licence CraftPix) vers
static/backgrounds/ (committé), même patron que
generate_animal_sprite_manifest.py.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-02 12:24:10 +02:00

53 lines
2.1 KiB
Python

import json
import os
# Bibliothèque d'images de fond CraftPix — RÉSERVÉE au rôle admin (voir
# core/sprite_gate.py, routes/scenes/scene_object_add.py), même règle que
# la bibliothèque de sprites animaux (screens/labels/animal_sprite_library.py) :
# licence CraftPix, interdiction de rendre ces images utilisables par un
# compte "user". Générée une fois par
# scripts/generate_background_manifest.py depuis assets/background/<pack>/
# (pack source, non versionné) vers static/backgrounds/<pack_slug>/
# <image>.png, avec un manifest JSON portant les dimensions RÉELLES
# (largeur/hauteur) de chaque image — utilisées comme taille par défaut de
# l'objet de scène "fond" posé (voir screens/scenes/add_scene_object.py),
# modifiable ensuite comme n'importe quel objet (panneau "Position & taille").
_MANIFEST_PATH = os.path.join(
os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
"static", "backgrounds", "manifest.json",
)
def _load_manifest():
try:
with open(_MANIFEST_PATH, encoding="utf-8") as f:
return json.load(f)
except FileNotFoundError:
# Poste de dev sans les images de fond copiées (script pas encore
# lancé), ou paquet exporté pour un jeu qui n'utilise aucun fond
# CraftPix (voir publish/build_scorm_package.py, à étendre pour
# copier sélectivement static/backgrounds/ le jour où un export
# utilise ce widget) : aucun fond disponible, pas une erreur.
return {}
def _build_library():
manifest = _load_manifest()
library = {}
for pack_slug, pack in manifest.items():
pack_label = pack["label"]
for image_name, dims in pack["images"].items():
slug = f"{pack_slug}-{image_name}"
library[slug] = {
"label": f"{pack_label} — {image_name.replace('_', ' ')}",
"url": f"/static/backgrounds/{pack_slug}/{image_name}.png",
"width": dims["width"],
"height": dims["height"],
"pack": pack_slug,
"pack_label": pack_label,
}
return library
BACKGROUND_LIBRARY = _build_library()