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;
87
88// Corner routines (19, 35-37, 75-78)
89constexpr int kCorner4x4 = 19;
90constexpr int kCorner4x4_BothBG = 35;
91constexpr int kWeirdCornerBottom_BothBG = 36;
92constexpr int kWeirdCornerTop_BothBG = 37;
93constexpr int kDiagonalCeilingTopLeft = 75;
94constexpr int kDiagonalCeilingBottomLeft = 76;
95constexpr int kDiagonalCeilingTopRight = 77;
96constexpr int kDiagonalCeilingBottomRight = 78;
97
98// Special routines (26, 33-34, 38-39)
99constexpr int kDoorSwitcherer = 26;
100constexpr int kSomariaLine = 33;
101constexpr int kWaterFace = 34;
102constexpr int kNothing = 38;
103constexpr int kChest = 39;
104
105// Additional rightwards (51-55, 72-74)
106constexpr int kRightwards4x2_1to16 = 40;
110constexpr int kRightwardsBar4x3_1to16 = 52;
111constexpr int kRightwardsShelf4x4_1to16 = 53;
115constexpr int kRightwardsPots2x2_1to16 = 73;
117
118// SuperSquare routines (56-64)
119constexpr int k4x4BlocksIn4x4SuperSquare = 56;
120constexpr int k3x3FloorIn4x4SuperSquare = 57;
121constexpr int k4x4FloorIn4x4SuperSquare = 58;
124constexpr int kBigHole4x4_1to16 = 61;
125constexpr int kSpike2x2In4x4SuperSquare = 62;
126constexpr int kTableRock4x4_1to16 = 63;
127constexpr int kWaterOverlay8x8_1to16 = 64;
128
129// Chest platform and moving wall routines (79-82)
130constexpr int kClosedChestPlatform = 79;
131constexpr int kMovingWallWest = 80;
132constexpr int kMovingWallEast = 81;
133constexpr int kOpenChestPlatform = 82;
134
135// Stair routines (83-91)
136constexpr int kInterRoomFatStairsUp = 83;
137constexpr int kInterRoomFatStairsDownA = 84;
138constexpr int kInterRoomFatStairsDownB = 85;
139constexpr int kAutoStairs = 86;
140constexpr int kStraightInterRoomStairs = 87;
141constexpr int kSpiralStairsGoingUpUpper = 88;
143constexpr int kSpiralStairsGoingUpLower = 90;
145
146// Interactive object routines (92-96)
147constexpr int kBigKeyLock = 92;
148constexpr int kBombableFloor = 93;
149constexpr int kEmptyWaterFace = 94;
150constexpr int kSpittingWaterFace = 95;
151constexpr int kDrenchingWaterFace = 96;
152
153// Additional Type 2/3 routines (97-116)
154constexpr int kPrisonCell = 97;
155constexpr int kBed4x5 = 98;
156constexpr int kRightwards3x6 = 99;
157constexpr int kUtility6x3 = 100;
158constexpr int kUtility3x5 = 101;
159constexpr int kVerticalTurtleRockPipe = 102;
160constexpr int kHorizontalTurtleRockPipe = 103;
161constexpr int kLightBeam = 104;
162constexpr int kBigLightBeam = 105;
163constexpr int kBossShell4x4 = 106;
164constexpr int kSolidWallDecor3x4 = 107;
165constexpr int kArcheryGameTargetDoor = 108;
166constexpr int kGanonTriforceFloorDecor = 109;
167constexpr int kSingle2x2 = 110;
168constexpr int kWaterfall47 = 111;
169constexpr int kWaterfall48 = 112;
170constexpr int kSingle4x4 = 113;
171constexpr int kSingle4x3 = 114;
172constexpr int kRupeeFloor = 115;
173constexpr int kActual4x4 = 116;
174
175// Custom object routines (130+)
176constexpr int kCustomObject = 130;
177
178} // namespace DrawRoutineIds
179
188 public:
189 static DrawRoutineRegistry& Get();
190
191 // Initialize the registry - must be called once at startup
192 void Initialize();
193
194 // Rebuild object->routine mapping after runtime feature-flag changes.
196
197 // Look up routine info by ID
198 const DrawRoutineInfo* GetRoutineInfo(int routine_id) const;
199
200 // Get all registered routines
201 const std::vector<DrawRoutineInfo>& GetAllRoutines() const {
202 return routines_;
203 }
204
205 // Check if a routine draws to both BG layers
206 bool RoutineDrawsToBothBGs(int routine_id) const;
207
208 // Get routine metadata for dimension calculation
209 bool GetRoutineDimensions(int routine_id, int* base_width,
210 int* base_height) const;
211
212 // Look up draw routine ID for an object ID. Returns -1 if unmapped.
213 int GetRoutineIdForObject(int16_t object_id) const;
214
215 private:
217 void BuildRegistry();
218 void BuildObjectMapping();
219
220 std::vector<DrawRoutineInfo> routines_;
221 std::unordered_map<int, const DrawRoutineInfo*> routine_map_;
222 std::unordered_map<int16_t, int> object_to_routine_map_;
223 bool initialized_ = false;
224};
225
226} // namespace zelda3
227} // namespace yaze
228
229#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.