Mario Kart 64
Loading...
Searching...
No Matches
Course.h
Go to the documentation of this file.
1#ifndef ENGINE_COURSE_H
2#define ENGINE_COURSE_H
3
4#include <libultraship/libultraship.h>
5#include "CoreMath.h"
6
7#ifdef __cplusplus
9#include <optional>
10#include <nlohmann/json.hpp>
13extern "C" {
14#endif
15
16#include "camera.h"
17#include "course_offsets.h"
18#include "data/some_data.h"
19#include "defines.h"
20#include "bomb_kart.h"
21#include "path_spawn_metadata.h"
22#include "waypoints.h"
23#include "sounds.h"
24#include "common_structs.h"
25
26#ifdef __cplusplus
27}
28#endif
29
40
41// Extends infinitely in the Y direction
42// If a player is overtop of a water volume then it should use its height
43// Recommend using the new water surface type. This is here to support the stock tracks.
44// Albeit, there's no reason you cannot use this so long as you input a square.
45// How to use: WaterVolumes.push_back({0, -100, 100, -100, 100});
47 float Height; // Y coordinate of the Water level
48 float MinX;
49 float MaxX;
50 float MinZ;
51 float MaxZ;
52};
53
54typedef struct MinimapProps {
55 const char* Texture;
56 int16_t Width;
57 int16_t Height;
58 IVector2D Pos[2]; // Minimap position for players 1 and 2. 3/4 player mode is hard-coded to the center.
59 int32_t PlayerX; // The offset to place the player markers
60 int32_t PlayerY;
61 float PlayerScaleFactor; // Scale factor of the player markers
62 float FinishlineX; // The offset to place the finishline texture on the minimap
64 RGB8 Colour; // Colour of the visible pixels (the track path)
66
67void ResizeMinimap(MinimapProps* minimap);
68void ReverseGfx(Gfx* gfx);
69
70void InvertTriangleWinding(Gfx* gfx);
71void InvertTriangleWindingByName(const char* name);
74
75typedef struct Properties {
76 char Name[128];
77 char DebugName[128];
78 char CourseLength[128];
81 const char* AIBehaviour;
84 float NearPersp;
85 float FarPersp;
86 int16_t* AIDistance;
93 TrackPathPoint* PathTable[4]; // Only used for podium ceremony
94 TrackPathPoint* PathTable2[5]; // The fifth entry is for vehicles
95 uint8_t* CloudTexture;
100 float WaterLevel; // Used for effects, and Lakitu pick up height. Not necessarily the visual water model height.
101
102#ifdef __cplusplus
103 nlohmann::json to_json() const {
104 nlohmann::json j;
105 // j["Id"] = Id ? Id : "";
106 j["Name"] = Name ? Name : "";
107 j["DebugName"] = DebugName ? DebugName : "";
108 j["CourseLength"] = CourseLength ? CourseLength : "";
109 //j["AIBehaviour"] = AIBehaviour ? AIBehaviour : "";
110 j["LakituTowType"] = LakituTowType;
111 j["AIMaximumSeparation"] = AIMaximumSeparation;
112 j["AIMinimumSeparation"] = AIMinimumSeparation;
113 j["NearPersp"] = NearPersp;
114 j["FarPersp"] = FarPersp;
115
116 // AIDistance as a JSON array
117 j["AIDistance"] = std::vector<int16_t>(AIDistance, AIDistance + 32); // gAIDistances array size of 32
118
119 j["AISteeringSensitivity"] = AISteeringSensitivity;
120
121 // PathSizes - Assuming _struct_gCoursePathSizes_0x10 can be serialized similarly
122 // j["PathSizes"] = PathSizes; // Implement your serialization logic here
123
124 j["CurveTargetSpeed"] = { CurveTargetSpeed[0], CurveTargetSpeed[1], CurveTargetSpeed[2], CurveTargetSpeed[3] };
125 j["NormalTargetSpeed"] = { NormalTargetSpeed[0], NormalTargetSpeed[1], NormalTargetSpeed[2], NormalTargetSpeed[3] };
126 j["D_0D0096B8"] = { D_0D0096B8[0], D_0D0096B8[1], D_0D0096B8[2], D_0D0096B8[3] };
127 j["OffTrackTargetSpeed"] = { OffTrackTargetSpeed[0], OffTrackTargetSpeed[1], OffTrackTargetSpeed[2], OffTrackTargetSpeed[3] };
128
129 // Serialize arrays PathTable and PathTable2 (convert pointers into a JSON array if possible)
130 //j["PathTable"] = {{}};
131 //j["PathTable2"] = {{}};
132 // Populate PathTable and PathTable2
133
134 //j["Clouds"] = Clouds ? nlohmann::json{{"x", Clouds->x, "y", Clouds->y, "z", Clouds->z}} : nullptr;
135 //j["CloudList"] = CloudList ? nlohmann::json{{"x", CloudList->x, "y", CloudList->y, "z", CloudList->z}} : nullptr;
136
137 j["MinimapPosition"] = {Minimap.Pos[0].X, Minimap.Pos[0].Y};
138 j["MinimapPosition2P"] = {Minimap.Pos[1].X, Minimap.Pos[1].Y};
139 j["MinimapPlayerX"] = Minimap.PlayerX;
140 j["MinimapPlayerY"] = Minimap.PlayerY;
141 j["MinimapPlayerScaleFactor"] = Minimap.PlayerScaleFactor;
142 j["MinimapFinishlineX"] = Minimap.FinishlineX;
143 j["MinimapFinishlineY"] = Minimap.FinishlineY;
144 j["MinimapColour"] = {static_cast<int>(Minimap.Colour.r), static_cast<int>(Minimap.Colour.g), static_cast<int>(Minimap.Colour.b)};
145 // SkyboxColors - assuming SkyboxColors can be serialized similarly
146
147 #define TO_INT(value) static_cast<int>(value)
148 j["Skybox"] = {
149 TO_INT(Skybox.TopRight.r), TO_INT(Skybox.TopRight.g), TO_INT(Skybox.TopRight.b),
150 TO_INT(Skybox.BottomRight.r), TO_INT(Skybox.BottomRight.g), TO_INT(Skybox.BottomRight.b),
151 TO_INT(Skybox.BottomLeft.r), TO_INT(Skybox.BottomLeft.g), TO_INT(Skybox.BottomLeft.b),
152 TO_INT(Skybox.TopLeft.r), TO_INT(Skybox.TopLeft.g), TO_INT(Skybox.TopLeft.b),
153 TO_INT(Skybox.FloorTopRight.r), TO_INT(Skybox.FloorTopRight.g), TO_INT(Skybox.FloorTopRight.b),
154 TO_INT(Skybox.FloorBottomRight.r), TO_INT(Skybox.FloorBottomRight.g), TO_INT(Skybox.FloorBottomRight.b),
155 TO_INT(Skybox.FloorBottomLeft.r), TO_INT(Skybox.FloorBottomLeft.g), TO_INT(Skybox.FloorBottomLeft.b),
156 TO_INT(Skybox.FloorTopLeft.r), TO_INT(Skybox.FloorTopLeft.g), TO_INT(Skybox.FloorTopLeft.b)
157 };
158 j["Sequence"] = static_cast<int>(Sequence);
159
160 j["WaterLevel"] = static_cast<float>(WaterLevel);
161 #undef CAST_TO_INT
162
163 return j;
164 }
165
166 // Function to load struct from JSON
167 void from_json(const nlohmann::json& j) {
168 //Id = j.at("Id").get<std::string>().c_str();
169// Name = j.at("Name").get<std::string>().c_str();
170 strncpy(Name, j.at("Name").get<std::string>().c_str(), sizeof(Name) - 1);
171 Name[sizeof(Name) - 1] = '\0'; // Ensure null termination
172
173// DebugName = j.at("DebugName").get<std::string>().c_str();
174 strncpy(DebugName, j.at("DebugName").get<std::string>().c_str(), sizeof(DebugName) - 1);
175 DebugName[sizeof(DebugName) - 1] = '\0'; // Ensure null termination
176
177 // CourseLength = j.at("CourseLength").get<std::string>().c_str();
178 strncpy(CourseLength, j.at("CourseLength").get<std::string>().c_str(), sizeof(CourseLength) - 1);
179 CourseLength[sizeof(CourseLength) - 1] = '\0'; // Ensure null termination
180
181 //AIBehaviour = j.at("AIBehaviour").get<std::string>().c_str();
182 LakituTowType = j.at("LakituTowType").get<int>();
183
184 AIMaximumSeparation = j.at("AIMaximumSeparation").get<float>();
185 AIMinimumSeparation = j.at("AIMinimumSeparation").get<float>();
186 NearPersp = j.at("NearPersp").get<float>();
187 FarPersp = j.at("FarPersp").get<float>();
188
189 const auto temp = j.at("AIDistance").get<std::vector<int16_t>>();
190
191 // Ensure the vector has 32 entries
192 if (temp.size() == 32) {
193 // Copy the data into the existing AIDistances array
194 std::copy(temp.begin(), temp.end(), AIDistance);
195 } else {
196 printf("Course::from_json() AIDistance array not size of 32\n");
197 }
198
199 AISteeringSensitivity = j.at("AISteeringSensitivity").get<uint32_t>();
200
201 // Deserialize PathSizes and other custom structs if needed
202
203 CurveTargetSpeed[0] = j.at("CurveTargetSpeed")[0].get<float>();
204 CurveTargetSpeed[1] = j.at("CurveTargetSpeed")[1].get<float>();
205 CurveTargetSpeed[2] = j.at("CurveTargetSpeed")[2].get<float>();
206 CurveTargetSpeed[3] = j.at("CurveTargetSpeed")[3].get<float>();
207
208 NormalTargetSpeed[0] = j.at("NormalTargetSpeed")[0].get<float>();
209 NormalTargetSpeed[1] = j.at("NormalTargetSpeed")[1].get<float>();
210 NormalTargetSpeed[2] = j.at("NormalTargetSpeed")[2].get<float>();
211 NormalTargetSpeed[3] = j.at("NormalTargetSpeed")[3].get<float>();
212
213 D_0D0096B8[0] = j.at("D_0D0096B8")[0].get<float>();
214 D_0D0096B8[1] = j.at("D_0D0096B8")[1].get<float>();
215 D_0D0096B8[2] = j.at("D_0D0096B8")[2].get<float>();
216 D_0D0096B8[3] = j.at("D_0D0096B8")[3].get<float>();
217
218 OffTrackTargetSpeed[0] = j.at("OffTrackTargetSpeed")[0].get<float>();
219 OffTrackTargetSpeed[1] = j.at("OffTrackTargetSpeed")[1].get<float>();
220 OffTrackTargetSpeed[2] = j.at("OffTrackTargetSpeed")[2].get<float>();
221 OffTrackTargetSpeed[3] = j.at("OffTrackTargetSpeed")[3].get<float>();
222
223 // Deserialize arrays PathTable and PathTable2 similarly
224
225 //Clouds = nullptr; // Deserialize if data is present
226 //CloudList = nullptr; // Deserialize if data is present
227 Minimap.Pos[0].X = j.at("MinimapPosition")[0].get<int32_t>();
228 Minimap.Pos[0].Y = j.at("MinimapPosition")[1].get<int32_t>();
229 Minimap.Pos[1].X = j.at("MinimapPosition2P")[0].get<int32_t>();
230 Minimap.Pos[1].Y = j.at("MinimapPosition2P")[1].get<int32_t>();
231 Minimap.PlayerX = j.at("MinimapPlayerX").get<int32_t>();
232 Minimap.PlayerY = j.at("MinimapPlayerY").get<int32_t>();
233 Minimap.PlayerScaleFactor = j.at("MinimapPlayerScaleFactor").get<float>();
234 Minimap.FinishlineX = j.at("MinimapFinishlineX").get<float>();
235 Minimap.FinishlineY = j.at("MinimapFinishlineY").get<float>();
236 Minimap.Colour.r = j.at("MinimapColour")[0].get<uint8_t>();
237 Minimap.Colour.g = j.at("MinimapColour")[1].get<uint8_t>();
238 Minimap.Colour.b = j.at("MinimapColour")[2].get<uint8_t>();
239 //textures = nullptr; // Deserialize textures if present
240
241 Skybox.TopRight.r = j.at("Skybox")[0].get<uint8_t>();
242 Skybox.TopRight.g = j.at("Skybox")[1].get<uint8_t>();
243 Skybox.TopRight.b = j.at("Skybox")[2].get<uint8_t>();
244
245 Skybox.BottomRight.r = j.at("Skybox")[3].get<uint8_t>();
246 Skybox.BottomRight.g = j.at("Skybox")[4].get<uint8_t>();
247 Skybox.BottomRight.b = j.at("Skybox")[5].get<uint8_t>();
248
249 Skybox.BottomLeft.r = j.at("Skybox")[6].get<uint8_t>();
250 Skybox.BottomLeft.g = j.at("Skybox")[7].get<uint8_t>();
251 Skybox.BottomLeft.b = j.at("Skybox")[8].get<uint8_t>();
252
253 Skybox.TopLeft.r = j.at("Skybox")[9].get<uint8_t>();
254 Skybox.TopLeft.g = j.at("Skybox")[10].get<uint8_t>();
255 Skybox.TopLeft.b = j.at("Skybox")[11].get<uint8_t>();
256
257 Skybox.FloorTopRight.r = j.at("Skybox")[12].get<uint8_t>();
258 Skybox.FloorTopRight.g = j.at("Skybox")[13].get<uint8_t>();
259 Skybox.FloorTopRight.b = j.at("Skybox")[14].get<uint8_t>();
260
261 Skybox.FloorBottomRight.r = j.at("Skybox")[15].get<uint8_t>();
262 Skybox.FloorBottomRight.g = j.at("Skybox")[16].get<uint8_t>();
263 Skybox.FloorBottomRight.b = j.at("Skybox")[17].get<uint8_t>();
264
265 Skybox.FloorBottomLeft.r = j.at("Skybox")[18].get<uint8_t>();
266 Skybox.FloorBottomLeft.g = j.at("Skybox")[19].get<uint8_t>();
267 Skybox.FloorBottomLeft.b = j.at("Skybox")[20].get<uint8_t>();
268
269 Skybox.FloorTopLeft.r = j.at("Skybox")[21].get<uint8_t>();
270 Skybox.FloorTopLeft.g = j.at("Skybox")[22].get<uint8_t>();
271 Skybox.FloorTopLeft.b = j.at("Skybox")[23].get<uint8_t>();
272
273 Sequence = static_cast<MusicSeq>(j.at("Sequence").get<int>());
274 WaterLevel = j.at("WaterLevel").get<float>();
275 }
276 void SetText(char* name, const char* title, size_t bufferSize) {
277 // Copy the title into the name buffer, ensuring it's null-terminated and within bounds
278 std::strncpy(name, title, bufferSize - 1);
279 name[bufferSize - 1] = '\0'; // Ensure the string is null-terminated
280 }
281
282 const char* GetName() {
283 return Name;
284 }
285
286 void New() {
287 SetText(Name, "", sizeof(Name));
288 SetText(DebugName, "", sizeof(DebugName));
289 SetText(CourseLength, "", sizeof(CourseLength));
290 }
291#endif
292
294
295#ifdef __cplusplus
296
297
298class World; // <-- Forward declare
299
300class Course {
301
302public:
303 std::string Id;
304 Properties Props;
305
306 // This allows multiple water levels in a map.
307 // Ex. DK Jungle where there's a waterfall and you can drive above and below it.
308 std::vector<WaterVolume> WaterVolumes;
309
310 bool bSpawnFinishline = true;
311 std::optional<FVector> FinishlineSpawnPoint;
312
313 // O2R Loading
314 std::shared_ptr<Ship::Archive> RootArchive;
315 std::string SceneFilePtr;
316 std::string TrackSectionsPtr;
317
318 bool bIsMod = false;
319 std::vector<SpawnParams> SpawnList;
320
321 virtual ~Course() = default;
322
323 explicit Course();
324
325 virtual void LoadO2R(std::string trackPath); // Load custom track from o2r
326 virtual void Load(); // Decompress and load stock courses or from o2r but TrackSectionsPtr must be set.
327 virtual void Load(Vtx* vtx, Gfx *gfx); // Load custom track from code. Load must be overridden and then call to this base class method impl.
328 virtual void UnLoad();
329 virtual void ParseCourseSections(TrackSections* sections, size_t size);
330
335 virtual void BeginPlay();
336 void SpawnActors();
337 virtual void TestPath();
338 virtual void InitClouds();
339 virtual void UpdateClouds(s32, Camera*);
340 virtual void SomeCollisionThing(Player *player, Vec3f arg1, Vec3f arg2, Vec3f arg3, f32* arg4, f32* arg5, f32* arg6, f32* arg7);
341 virtual void InitCourseObjects();
342 virtual void UpdateCourseObjects();
343 virtual void RenderCourseObjects(s32 cameraId);
344 virtual void SomeSounds();
345 virtual void CreditsSpawnActors();
346 virtual void WhatDoesThisDo(Player*, int8_t);
347 virtual void WhatDoesThisDoAI(Player*, int8_t);
348 virtual void SetStaffGhost();
349 virtual void Render(struct UnkStruct_800DC5EC*);
350 virtual void RenderCredits();
351 virtual void Waypoints(Player* player, int8_t playerId);
352 virtual f32 GetWaterLevel(FVector pos, Collision* collision);
353 virtual void ScrollingTextures();
354 // Draw transparent models (water, signs, arrows, etc.)
355 virtual void DrawWater(struct UnkStruct_800DC5EC* screen, uint16_t pathCounter, uint16_t cameraRot,
356 uint16_t playerDirection);
357 virtual void Destroy();
358 virtual bool IsMod();
359
360 private:
361 void Init();
362};
363
364#endif
365
366#endif // ENGINE_COURSE_H
void InvertTriangleWindingByName(const char *name)
Definition Course.cpp:183
void ReverseGfx(Gfx *gfx)
void RestoreTriangleWinding()
Definition Course.cpp:192
struct Properties Properties
void ResizeMinimap(MinimapProps *minimap)
Definition Course.cpp:38
void InvertTriangleWinding(Gfx *gfx)
Definition Course.cpp:179
bool IsTriangleWindingInverted()
Definition Course.cpp:241
Definition World.h:36
f32 Vec3f[3]
Definition common_structs.h:10
f32 Vec4f[4]
Definition common_structs.h:11
#define j
void SpawnActors(std::vector< std::pair< std::string, SpawnParams > > spawnList)
void Destroy()
Definition ImguiUI.cpp:97
@ f32
Definition GenericArray.h:59
struct StarData CloudData
MusicSeq
Definition sounds.h:118
Definition CoreMath.h:115
Definition Course.h:54
IVector2D Pos[2]
Definition Course.h:58
int16_t Width
Definition Course.h:56
RGB8 Colour
Definition Course.h:64
float FinishlineY
Definition Course.h:63
int32_t PlayerY
Definition Course.h:60
const char * Texture
Definition Course.h:55
float PlayerScaleFactor
Definition Course.h:61
float FinishlineX
Definition Course.h:62
int32_t PlayerX
Definition Course.h:59
int16_t Height
Definition Course.h:57
Definition Course.h:75
char Name[128]
Definition Course.h:76
uint8_t * CloudTexture
Definition Course.h:95
_struct_gCoursePathSizes_0x10 PathSizes
Definition Course.h:88
TrackPathPoint * PathTable2[5]
Definition Course.h:94
CloudData * Clouds
Definition Course.h:96
Vec4f D_0D0096B8
Definition Course.h:91
Vec4f CurveTargetSpeed
Definition Course.h:89
float AIMaximumSeparation
Definition Course.h:82
float WaterLevel
Definition Course.h:100
int32_t LakituTowType
Definition Course.h:79
Vec4f OffTrackTargetSpeed
Definition Course.h:92
uint32_t AISteeringSensitivity
Definition Course.h:87
TrackPathPoint * PathTable[4]
Definition Course.h:93
const char * AIBehaviour
Definition Course.h:81
char CourseLength[128]
Definition Course.h:78
float NearPersp
Definition Course.h:84
SkyboxColours Skybox
Definition Course.h:98
float AIMinimumSeparation
Definition Course.h:83
enum MusicSeq Sequence
Definition Course.h:99
int16_t * AIDistance
Definition Course.h:86
char DebugName[128]
Definition Course.h:77
CloudData * CloudList
Definition Course.h:97
float FarPersp
Definition Course.h:85
MinimapProps Minimap
Definition Course.h:80
Vec4f NormalTargetSpeed
Definition Course.h:90
Definition common_structs.h:427
Definition Course.h:30
RGB8 BottomLeft
Definition Course.h:33
RGB8 FloorBottomRight
Definition Course.h:36
RGB8 BottomRight
Definition Course.h:32
RGB8 FloorBottomLeft
Definition Course.h:37
RGB8 TopRight
Definition Course.h:31
RGB8 TopLeft
Definition Course.h:34
RGB8 FloorTopRight
Definition Course.h:35
RGB8 FloorTopLeft
Definition Course.h:38
Definition waypoints.h:14
Definition Course.h:46
float Height
Definition Course.h:47
float MaxX
Definition Course.h:49
float MinZ
Definition Course.h:50
float MinX
Definition Course.h:48
float MaxZ
Definition Course.h:51
Definition path_spawn_metadata.h:9