yaze 0.3.2
Link to the Past ROM Editor
 
Loading...
Searching...
No Matches
draw_routine_registry.h
Go to the documentation of this file.
1#ifndef YAZE_ZELDA3_DUNGEON_DRAW_ROUTINES_DRAW_ROUTINE_REGISTRY_H
2#define YAZE_ZELDA3_DUNGEON_DRAW_ROUTINES_DRAW_ROUTINE_REGISTRY_H
3
4#include <cstdint>
5#include <unordered_map>
6#include <vector>
7
9
10namespace yaze {
11namespace zelda3 {
12
22namespace DrawRoutineIds {
23
24// Rightwards routines (0-4, 16, 20-32)
25constexpr int kRightwards2x2_1to15or32 = 0;
26constexpr int kRightwards2x4_1to15or26 = 1;
27constexpr int kRightwards2x4_1to16 = 2;
29constexpr int kRightwards2x2_1to16 = 4;
30constexpr int kRightwards4x4_1to16 = 16;
31constexpr int kRightwards1x2_1to16_plus2 = 20;
44constexpr int kWeird2x4_1to16 = 124;
45
46// Diagonal routines (5-6, 17-18)
47constexpr int kDiagonalAcute_1to16 = 5;
48constexpr int kDiagonalGrave_1to16 = 6;
49constexpr int kDiagonalAcute_1to16_BothBG = 17;
50constexpr int kDiagonalGrave_1to16_BothBG = 18;
51
52// Downwards routines (7-15, 43-50, 65-71)
53constexpr int kDownwards2x2_1to15or32 = 7;
54constexpr int kDownwards4x2_1to15or26 = 8;
57constexpr int kDownwards2x2_1to16 = 11;
59constexpr int kDownwardsEdge1x1_1to16 = 13;
62constexpr int kDownwardsFloor4x4_1to16 = 43;
74constexpr int kDownwardsBar2x5_1to16 = 69;
75constexpr int kDownwardsPots2x2_1to16 = 70;
77
78// Long vertical rail and jump-ledge variants.
80constexpr int kWaterHopStairsA = 119;
81constexpr int kWaterHopStairsB = 120;
82constexpr int kDamFloodGate = 121;
83constexpr int kDownwardsEdge1x1_1to16plus7 = 122;
84
85// Late special routines.
86constexpr int kFloorLight = 123;
87constexpr int kBigWallDecor = 125;
88constexpr int kTableBowl = 126;
89constexpr int kSmithyFurnace = 127;
90constexpr int kBigGrayRock = 128;
91constexpr int kAgahnimsAltar = 129;
92constexpr int kFortuneTellerRoom = 131;
93
94// Corner routines (19, 35-37, 75-78)
95constexpr int kCorner4x4 = 19;
96constexpr int kCorner4x4_BothBG = 35;
97constexpr int kWeirdCornerBottom_BothBG = 36;
98constexpr int kWeirdCornerTop_BothBG = 37;
99constexpr int kDiagonalCeilingTopLeft = 75;
100constexpr int kDiagonalCeilingBottomLeft = 76;
101constexpr int kDiagonalCeilingTopRight = 77;
103
104// Special routines (26, 33-34, 38-39)
105constexpr int kDoorSwitcherer = 26;
106constexpr int kSomariaLine = 33;
107constexpr int kWaterFace = 34;
108constexpr int kNothing = 38;
109constexpr int kChest = 39;
110
111// Additional rightwards (51-55, 72-74)
112constexpr int kRightwards4x2_1to16 = 40;
116constexpr int kRightwardsBar4x3_1to16 = 52;
117constexpr int kRightwardsShelf4x4_1to16 = 53;
121constexpr int kRightwardsPots2x2_1to16 = 73;
123
124// SuperSquare routines (56-64)
125constexpr int k4x4BlocksIn4x4SuperSquare = 56;
126constexpr int k3x3FloorIn4x4SuperSquare = 57;
127constexpr int k4x4FloorIn4x4SuperSquare = 58;
130constexpr int kBigHole4x4_1to16 = 61;
131constexpr int kSpike2x2In4x4SuperSquare = 62;
132constexpr int kTableRock4x4_1to16 = 63;
133constexpr int kWaterOverlay8x8_1to16 = 64;
134
135// Chest platform and moving wall routines (79-82)
136constexpr int kClosedChestPlatform = 79;
137constexpr int kMovingWallWest = 80;
138constexpr int kMovingWallEast = 81;
139constexpr int kOpenChestPlatform = 82;
140
141// Stair routines (83-91)
142constexpr int kInterRoomFatStairsUp = 83;
143constexpr int kInterRoomFatStairsDownA = 84;
144constexpr int kInterRoomFatStairsDownB = 85;
145constexpr int kAutoStairs = 86;
146constexpr int kStraightInterRoomStairs = 87;
147constexpr int kSpiralStairsGoingUpUpper = 88;
149constexpr int kSpiralStairsGoingUpLower = 90;
151
152// Interactive object routines (92-96)
153constexpr int kBigKeyLock = 92;
154constexpr int kBombableFloor = 93;
155constexpr int kEmptyWaterFace = 94;
156constexpr int kSpittingWaterFace = 95;
157constexpr int kDrenchingWaterFace = 96;
158
159// Additional Type 2/3 routines (97-116)
160constexpr int kPrisonCell = 97;
161constexpr int kBed4x5 = 98;
162constexpr int kRightwards3x6 = 99;
163constexpr int kUtility6x3 = 100;
164constexpr int kUtility3x5 = 101;
165constexpr int kVerticalTurtleRockPipe = 102;
166constexpr int kHorizontalTurtleRockPipe = 103;
167constexpr int kLightBeam = 104;
168constexpr int kBigLightBeam = 105;
169constexpr int kBossShell4x4 = 106;
170constexpr int kSolidWallDecor3x4 = 107;
171constexpr int kArcheryGameTargetDoor = 108;
172constexpr int kGanonTriforceFloorDecor = 109;
173constexpr int kSingle2x2 = 110;
174constexpr int kWaterfall47 = 111;
175constexpr int kWaterfall48 = 112;
176constexpr int kSingle4x4 = 113;
177constexpr int kSingle4x3 = 114;
178constexpr int kRupeeFloor = 115;
179constexpr int kActual4x4 = 116;
180
181// Custom object routine.
182constexpr int kCustomObject = 130;
183
184} // namespace DrawRoutineIds
185
194 public:
195 static DrawRoutineRegistry& Get();
196
197 // Initialize the registry - must be called once at startup
198 void Initialize();
199
200 // Rebuild object->routine mapping after runtime feature-flag changes.
202
203 // Look up routine info by ID
204 const DrawRoutineInfo* GetRoutineInfo(int routine_id) const;
205
206 // Get all registered routines
207 const std::vector<DrawRoutineInfo>& GetAllRoutines() const {
208 return routines_;
209 }
210
211 // Check if a routine draws to both BG layers
212 bool RoutineDrawsToBothBGs(int routine_id) const;
213
214 // Get routine metadata for dimension calculation
215 bool GetRoutineDimensions(int routine_id, int* base_width,
216 int* base_height) const;
217
218 // Look up draw routine ID for an object ID. Returns -1 if unmapped.
219 int GetRoutineIdForObject(int16_t object_id) const;
220
221 private:
223 void BuildRegistry();
224 void BuildObjectMapping();
225
226 std::vector<DrawRoutineInfo> routines_;
227 std::unordered_map<int, const DrawRoutineInfo*> routine_map_;
228 std::unordered_map<int16_t, int> object_to_routine_map_;
229 bool initialized_ = false;
230};
231
232} // namespace zelda3
233} // namespace yaze
234
235#endif // YAZE_ZELDA3_DUNGEON_DRAW_ROUTINES_DRAW_ROUTINE_REGISTRY_H
Unified draw routine registry.
const DrawRoutineInfo * GetRoutineInfo(int routine_id) const
const std::vector< DrawRoutineInfo > & GetAllRoutines() const
bool GetRoutineDimensions(int routine_id, int *base_width, int *base_height) const
std::unordered_map< int16_t, int > object_to_routine_map_
bool RoutineDrawsToBothBGs(int routine_id) const
std::unordered_map< int, const DrawRoutineInfo * > routine_map_
int GetRoutineIdForObject(int16_t object_id) const
std::vector< DrawRoutineInfo > routines_
static DrawRoutineRegistry & Get()
constexpr int kDownwardsLeftCorners2x1_1to16_plus12
constexpr int kRightwardsBottomCorners1x2_1to16_plus13
constexpr int kDownwardsRightCorners2x1_1to16_plus12
constexpr int kRightwardsTopCorners1x2_1to16_plus13
Metadata about a draw routine.