HC-03: geometria del mapa traslladada de map.hpp al YAML de la piràmide

El bloc `geometry:` de pyramid.yaml porta les 9 constants base (grid, sarc,
pitch, HUD, murs); els derivats (corridor, board, origin, playfield) es
recalculen al `Map::loadFrom()`. `constexpr` passa a `const` on calia i
els membres estàtics adopten snake_case. Desbloqueja la iteració
"pirámide a pirámide" sense recompilar.
This commit is contained in:
JailDesigner committed 2026-04-20 17:32:56 +02:00
1 parent b895475716
commit e6c7f0dcfb
6 files changed
+153 -83

No files matched your search

+40 -46
View File
@@ -2,57 +2,48 @@
#include <SDL3/SDL.h>
#include <string>
// Mapa d'una piràmide: sala rectangular amb marcador superior, muros pels
// quatre costats i graella 4×4 de sarcòfags envoltada per un passadís a cada
// cantó. Mesures portades de l'AEE original (mapa.cpp: sarcòfag 50×20, pitch
// 65×35, passadís 15 px) i adaptades a 320×240 repartint els 40 px extra
// sobretot al mur frontal, que fa de primer pla per a la falsa perspectiva.
// quatre costats i graella de sarcòfags envoltada per un passadís a cada
// cantó. La geometria (graella, pitch, amplada de murs) es carrega des del
// bloc `geometry:` del YAML de la piràmide — així cada sala pot tenir la
// seua forma sense recompilar.
//
// Z-order: el render es divideix en fons (marcador + muros + sòl) i files
// de sarcòfags. El caller (GameScene) alternarà jugadors ordenats per la Y
// dels peus amb cada fila per a aconseguir la perspectiva falsa (el sarcòfag
// tapa el cos del jugador si aquest està "darrere"; el cap del jugador tapa
// el sarcòfag de la fila superior si està "davant").
// dels peus amb cada fila per a aconseguir la perspectiva falsa.
class Map {
public:
// Graella portada tal qual de l'AEE (4×4 sarcòfags, pitch 65×35).
static constexpr int GRID_COLS = 4;
static constexpr int GRID_ROWS = 5;
static constexpr int SARC_W = 48;
static constexpr int SARC_H = 16;
static constexpr int PITCH_X = 64;
static constexpr int PITCH_Y = 32;
// Geometria de la graella (carregada de pyramid.yaml > geometry).
// Membres estàtics no-constexpr: el nom segueix snake_case per tidy;
// callers (Player, GameScene) els consulten com `Map::playfield_x`.
inline static int grid_cols = 0;
inline static int grid_rows = 0;
inline static int sarc_w = 0;
inline static int sarc_h = 0;
inline static int pitch_x = 0;
inline static int pitch_y = 0;
// El pas entre sarcòfags (15×15) és exactament el que ha de cabre el
// jugador; el reutilitzem també com a passadís exterior (perímetre).
static constexpr int CORRIDOR_W = PITCH_X - SARC_W;
static constexpr int CORRIDOR_H = PITCH_Y - SARC_H;
static constexpr int OUTER_CORRIDOR = CORRIDOR_W;
// Cromat de la sala: marcador (HUD), mur posterior (dalt) i murs
// laterals. El mur frontal es deriva del passadís exterior inferior.
inline static int hud_h = 0;
inline static int back_wall_h = 0;
inline static int side_wall_w = 0;
// Dimensions del tauler complet (des del primer sarcòfag fins al cantó
// inferior dret de l'últim). Derivades: no cal tocar-les a mà.
static constexpr int BOARD_W = ((GRID_COLS - 1) * PITCH_X) + SARC_W;
static constexpr int BOARD_H = ((GRID_ROWS - 1) * PITCH_Y) + SARC_H;
// Cromat de la sala: marcador, mur posterior (dalt), murs laterals i mur
// frontal (baix). El frontal és més gros per absorbir els 40 px extra del
// pas de 320×200 → 320×240 i reforçar la falsa perspectiva.
static constexpr int HUD_H = 24;
static constexpr int BACK_WALL_H = 24;
static constexpr int SIDE_WALL_W = 24;
// Origen del tauler dins del canvas (cantó superior-esquerra del primer
// sarcòfag). Derivat: mur + passadís en cada eix.
static constexpr int ORIGIN_X = SIDE_WALL_W + OUTER_CORRIDOR;
static constexpr int ORIGIN_Y = HUD_H + BACK_WALL_H + OUTER_CORRIDOR;
// Límits de la zona jugable (on el jugador pot moure's lliurement, sense
// comptar encara les colisions contra sarcòfags). Serviran per al pas
// següent de colisions.
static constexpr int PLAYFIELD_X = SIDE_WALL_W;
static constexpr int PLAYFIELD_Y = HUD_H + BACK_WALL_H;
static constexpr int PLAYFIELD_W = BOARD_W + (2 * OUTER_CORRIDOR);
static constexpr int PLAYFIELD_H = BOARD_H + (2 * OUTER_CORRIDOR);
// Derivats de la geometria base: el pas entre sarcòfags ha de cabre
// exactament el jugador, i el mateix passadís s'usa a l'exterior.
inline static int corridor_w = 0;
inline static int corridor_h = 0;
inline static int outer_corridor = 0;
inline static int board_w = 0;
inline static int board_h = 0;
inline static int origin_x = 0;
inline static int origin_y = 0;
inline static int playfield_x = 0;
inline static int playfield_y = 0;
inline static int playfield_w = 0;
inline static int playfield_h = 0;
// Índexs a la paleta UI (data/palettes/sega-cube.pal). Centralitzats ací
// per a poder ajustar l'estètica sense buscar magic numbers pel codi.
@@ -61,15 +52,18 @@ class Map {
static constexpr Uint8 FLOOR = 40;
static constexpr Uint8 SARC = 160;
Map();
// Carrega el bloc `geometry:` del YAML i recalcula tots els derivats.
// Ha de cridar-se abans d'instanciar `Player` o consultar `collides()`:
// GameScene ho fa al ctor.
static void loadFrom(const std::string& yaml_path);
// Fons estàtic: marcador, muros (back/side/front) i sòl interior. No
// pinta cap sarcòfag; això queda per a renderSarcsRow() perquè el caller
// puga interleaveing amb els jugadors.
static void renderBackground();
// Pinta la fila `row` de sarcòfags (4 rectangles a pitch 65). El caller
// decideix quan cridar-la respecte als jugadors segons la seua Y.
// Pinta la fila `row` de sarcòfags. El caller decideix quan cridar-la
// respecte als jugadors segons la seua Y.
static void renderSarcsRow(int row);
// Y de la cara inferior dels sarcòfags de la fila `row` (la "baseline"