Image de fond de scène + caméra qui suit le personnage, fps d'animation cohérent
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

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>
This commit is contained in:
william
2026-09-02 12:24:10 +02:00
co-authored by Claude Sonnet 5
parent 5891c82c62
commit 9199897784
24 changed files with 581 additions and 33 deletions
+102
View File
@@ -0,0 +1,102 @@
"""Objet de scène kind="fond" (image de fond, voir
screens/scenes/add_scene_object.py) : posé à sa taille RÉELLE (voir
screens/labels/background_library.py), derrière tout le reste
(z_index très négatif), insensible au clic — et si plus grand que la
scène, "monde" que la caméra suit en défilant derrière le personnage
(voir static/js/play/personnage-controller.js, testé côté client dans
static/js/play/__tests__/personnage-controller.test.js)."""
import re
import screens
def _create_jeu2d_game(client, tmp_game_slug_cleanup, name="pytest_background"):
resp = client.post("/games/new", data={"name": name}, follow_redirects=False)
slug = tmp_game_slug_cleanup(resp.headers["Location"].rstrip("/").split("/")[-1])
screen_id = screens.create_screen(slug, "Scène 1", kind="jeu_2d")
return slug, screen_id
def _a_background_slug():
assert screens.BACKGROUND_LIBRARY, "aucune image de fond générée — lancer scripts/generate_background_manifest.py"
return next(iter(screens.BACKGROUND_LIBRARY))
def test_background_library_is_built_from_the_generated_manifest():
slug = _a_background_slug()
background = screens.BACKGROUND_LIBRARY[slug]
assert background["url"].startswith("/static/backgrounds/")
assert background["width"] > 0 and background["height"] > 0
def test_adding_a_fond_object_uses_the_image_real_size_and_sits_behind_everything(client, tmp_game_slug_cleanup):
slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
background_slug = _a_background_slug()
background = screens.BACKGROUND_LIBRARY[background_slug]
resp = client.post(
f"/game/{slug}/screens/{screen_id}/scene-objects/add",
data={"kind": "fond", "background_slug": background_slug},
follow_redirects=False,
)
assert resp.status_code == 302, resp.data
obj_id = int(re.search(r"selected=(\d+)", resp.headers["Location"]).group(1))
obj = screens.get_scene_object(slug, obj_id)
assert obj["kind"] == "fond"
assert obj["width"] == background["width"]
assert obj["height"] == background["height"]
assert obj["x"] == 0 and obj["y"] == 0
assert obj["z_index"] < 0 # toujours derrière un personnage/décor ajouté normalement (z_index >= 1)
assert obj["attributes"]["src"] == background["url"]
def test_fond_object_renders_as_an_image_with_the_sceneBackground_class(client, tmp_game_slug_cleanup):
slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
background_slug = _a_background_slug()
resp = client.post(
f"/game/{slug}/screens/{screen_id}/scene-objects/add",
data={"kind": "fond", "background_slug": background_slug},
follow_redirects=False,
)
obj_id = int(re.search(r"selected=(\d+)", resp.headers["Location"]).group(1))
obj = screens.get_scene_object(slug, obj_id)
html = screens.render_scene_object(obj)
assert 'class="sceneObjectSprite sceneBackground"' in html
assert f'data-object-id="{obj_id}"' in html
def test_fond_object_falls_back_to_default_size_without_a_known_background_slug(client, tmp_game_slug_cleanup):
"""Un slug invalide/absent (URL bidouillée, script de manifeste jamais
lancé sur ce poste) : l'objet est quand même créé, à la taille par
défaut générique (128x128, voir ensure_scene_schema.py) plutôt que de
planter."""
slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
resp = client.post(
f"/game/{slug}/screens/{screen_id}/scene-objects/add",
data={"kind": "fond", "background_slug": "ce-slug-nexiste-pas"},
follow_redirects=False,
)
assert resp.status_code == 302
obj_id = int(re.search(r"selected=(\d+)", resp.headers["Location"]).group(1))
obj = screens.get_scene_object(slug, obj_id)
assert obj["width"] == 128 and obj["height"] == 128
def test_background_gallery_route_rejects_a_non_admin_account(user_game, user_client):
resp = user_client.post(f"/game/{user_game}/screens/new", data={"name": "Scène", "kind": "jeu_2d"}, follow_redirects=False)
screen_id = int(re.search(r"/screens/(\d+)/edit", resp.headers["Location"]).group(1))
background_slug = _a_background_slug()
resp = user_client.post(
f"/game/{user_game}/screens/{screen_id}/scene-objects/add",
data={"kind": "fond", "background_slug": background_slug},
follow_redirects=False,
)
assert resp.status_code == 403
def test_background_gallery_hidden_from_non_admin_scene_editor(user_game, user_client):
resp = user_client.post(f"/game/{user_game}/screens/new", data={"name": "Scène", "kind": "jeu_2d"}, follow_redirects=False)
screen_id = int(re.search(r"/screens/(\d+)/edit", resp.headers["Location"]).group(1))
html = user_client.get(f"/game/{user_game}/screens/{screen_id}/edit").get_data(as_text=True)
assert "Images de fond" not in html