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

+7 -16
View File
@@ -104,22 +104,13 @@ void Player::update(float delta_time) {
snapToVerticalLane(delta_time);
}
// Guardem la posició prèvia i deixem que AnimatedSprite::update aplique
// la velocitat com sempre; així no dupliquem la integració temporal ni
// l'animació. Després, axis-separated collision: revertim i re-apliquem
// cada eix comprovant el mapa de colisions, de manera que el jugador
// llisca contra els sarcòfags en compte de quedar-se bloquejat en sec.
const float OLD_X = getPosX();
const float OLD_Y = getPosY();
AnimatedSprite::update(delta_time);
const float NEW_X = getPosX();
const float NEW_Y = getPosY();
setPos(OLD_X, OLD_Y);
setPosX(NEW_X);
if (map_.collides(baseBox())) { setPosX(OLD_X); }
setPosY(NEW_Y);
if (map_.collides(baseBox())) { setPosY(OLD_Y); }
// Animació del frame + moviment col·lisió-aware. `tryMove` aplica els
// deltes per eix i reverteix l'eix que col·lisiona, així el jugador
// llisca contra sarcòfags i murs en compte de quedar-se bloquejat en
// sec. La caixa que s'envia al callback és `collisionBox()` (override
// a Player retornant `getBaseBox()`), no el sprite sencer.
animate(delta_time);
tryMove(vx * delta_time, vy * delta_time, [this](const SDL_FRect& box) { return map_.collides(box); });
clampToPlayfield();