refactor(sprite): PATCH-01 add tryMove + virtual collisionBox to base

- Sprite: nou hook virtual `collisionBox() -> SDL_FRect` (default
  `pos_`). Subclasses amb falsa perspectiva el sobreescriuen amb una
  sub-caixa més petita.
- MovingSprite: nou `tryMove(dx, dy, CollisionFn)` que aplica eix a
  eix i reverteix l'eix que col·lisiona; deixa lliscar el sprite
  contra obstacles.
- Player: override `collisionBox()` retornant `getBaseBox()` i
  `update()` reescrita per fer `animate(dt) + tryMove(vx*dt, vy*dt,
  collidesFn)` en lloc del patró antic `update + revertir + reaplicar`.

El comportament observable és idèntic: la integració `v*dt` parteix
de la mateixa posició (post-snap), els revertits per col·lisió són
els mateixos i el `MOVED` que controla l'animació stand/walk segueix
comparant amb `FRAME_START_X/Y`.

Smoke tests 13/13 OK; log Game start → Bye! sota xvfb-run idèntic al
baseline. clang-tidy i cppcheck nets sobre els fitxers modificats.

Refs: docs/audit-game.md (PATCH-01).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
JailDesignerandClaude Opus 4.7 committed 2026-04-22 08:53:11 +02:00
1 parent 64e0178ee9
commit d9f6fb45f8
5 files changed
+41 -16

No files matched your search

+9
View File
@@ -19,6 +19,15 @@ class Sprite {
// Hook d'actualització per frame. Base buida (no hi ha Sprite pur a
// actualitzar); les subclasses mòbils/animades fan override.
virtual void update(float /*delta_time*/) {}
// Caixa que `MovingSprite::tryMove` envia al callback de col·lisió per
// decidir si el moviment és vàlid. Per defecte coincideix amb `pos_`
// (el sprite sencer); les subclasses que usen falsa perspectiva (p.ex.
// `Player`) la sobreescriuen amb una sub-caixa més petita (només els
// peus) per a que el cap puga sobresortir sense bloquejar el
// moviment.
[[nodiscard]] virtual auto collisionBox() const -> SDL_FRect { return pos_; }
virtual void render();
// Renderitza substituint l'índex source_color per target_color (ús típic:
// la classe Text, que recolora glifs monocroms per paràmetre).