Introduce `z64pause_menu.h` header (#1505)

* z64pause_menu.h

* move functions and variables

* Move PauseMenuPage

* move stuff that seems public to the new header

* KALEIDO_OVL_MAX

* bss

* review

* IS_PAUSED

* format

* add argument to pause macros

* Update include/z64pause_menu.h

Co-authored-by: Dragorn421 <Dragorn421@users.noreply.github.com>

* bss

* More IS_PAUSED I missed

* early returns

* bss

* empty commit to trigger GHA

* bss

* bss

* bss

* includes

* bss

---------

Co-authored-by: Dragorn421 <Dragorn421@users.noreply.github.com>

6 files changed, 252 insertions, 120 deletions

diff --git a/include/functions.h b/include/functions.h
index fdd61205e..8e819af55 100644
--- a/include/functions.h
+++ b/include/functions.h
@@ -294,11 +294,6 @@ void GetItem_Draw(PlayState* play, s16 drawId);
 
 u16 QuestHint_GetTatlTextId(PlayState* play);
 
-void func_800F4A10(PlayState* play);
-void KaleidoSetup_Update(PlayState* play);
-void KaleidoSetup_Init(PlayState* play);
-void KaleidoSetup_Destroy(PlayState* play);
-
 void Font_LoadChar(PlayState* play, u16 codePointIndex, s32 offset);
 void Font_LoadCharNES(PlayState* play, u8 codePointIndex, s32 offset);
 void Font_LoadMessageBoxEndIcon(Font* font, u16 icon);
@@ -518,18 +513,6 @@ void Inventory_IncrementSkullTokenCount(s16 sceneIndex);
 s16 Inventory_GetSkullTokenCount(s16 sceneIndex);
 void Inventory_SaveLotteryCodeGuess(PlayState* play);
 
-uintptr_t KaleidoManager_FaultAddrConv(uintptr_t address, void* param);
-void KaleidoManager_LoadOvl(KaleidoMgrOverlay* ovl);
-void KaleidoManager_ClearOvl(KaleidoMgrOverlay* ovl);
-void KaleidoManager_Init(PlayState* play);
-void KaleidoManager_Destroy(void);
-void* KaleidoManager_GetRamAddr(void* vram);
-void KaleidoScopeCall_LoadPlayer(void);
-void KaleidoScopeCall_Init(PlayState* play);
-void KaleidoScopeCall_Destroy(PlayState* play);
-void KaleidoScopeCall_Update(PlayState* play);
-void KaleidoScopeCall_Draw(PlayState* play);
-
 void Play_SetMotionBlurAlpha(u32 alpha);
 void Play_EnableMotionBlur(u32 alpha);
 void Play_DisableMotionBlur(void);
diff --git a/include/regs.h b/include/regs.h
index bc518e6ba..ea0a85387 100644
--- a/include/regs.h
+++ b/include/regs.h
@@ -84,7 +84,7 @@ extern RegEditor* gRegEditor;
 #define R_MOTION_BLUR_ENABLED             SREG(91)
 #define R_MOTION_BLUR_PRIORITY_ALPHA      SREG(92)
 #define R_MOTION_BLUR_PRIORITY_ENABLED    SREG(93)
-#define R_PAUSE_BG_PRERENDER_STATE        SREG(94)
+#define R_PAUSE_BG_PRERENDER_STATE        SREG(94) // PauseBgPreRenderState enum
 
 #define R_PLAY_FILL_SCREEN_ON             MREG(64)
 #define R_PLAY_FILL_SCREEN_R              MREG(65)
diff --git a/include/variables.h b/include/variables.h
index deab22f85..6b2d2eb66 100644
--- a/include/variables.h
+++ b/include/variables.h
@@ -38,9 +38,6 @@ extern RomFile gObjectTable[OBJECT_ID_MAX];
 
 extern SceneTableEntry gSceneTable[SCENE_MAX];
 
-extern KaleidoMgrOverlay gKaleidoMgrOverlayTable[2];
-extern KaleidoMgrOverlay* gKaleidoMgrCurOvl;
-
 extern s32 gDbgCamEnabled;
 
 extern Vec3f gZeroVec3f;
@@ -82,6 +79,7 @@ extern u8 gSequenceTable[];
 extern u8 gSampleBankTable[];
 
 // bss
+
 extern s32 gTransitionTileState;
 extern Color_RGBA8_u32 gPlayVisMonoColor;
 
diff --git a/include/z64.h b/include/z64.h
index 8eb6e9beb..b4d805ea6 100644
--- a/include/z64.h
+++ b/include/z64.h
@@ -56,6 +56,7 @@
 #include "z64message.h"
 #include "z64object.h"
 #include "z64ocarina.h"
+#include "z64pause_menu.h"
 #include "z64player.h"
 #include "z64prerender.h"
 #include "z64save.h"
@@ -72,105 +73,6 @@
 #include "regs.h"
 
 
-typedef struct PauseContext {
-    /* 0x000 */ View view;
-    /* 0x168 */ u8* iconItemSegment;
-    /* 0x16C */ u8* iconItem24Segment;
-    /* 0x170 */ u8* iconItemAltSegment;
-    /* 0x174 */ u8* iconItemLangSegment;
-    /* 0x178 */ u8* nameSegment;
-    /* 0x17C */ u8* iconItemVtxSegment;
-    /* 0x180 */ Vtx* itemPageVtx;
-    /* 0x184 */ Vtx* mapPageVtx;
-    /* 0x188 */ Vtx* questPageVtx;
-    /* 0x18C */ Vtx* maskPageVtx;
-    /* 0x190 */ Vtx* itemVtx;
-    /* 0x194 */ Vtx* mapVtx; // inferred
-    /* 0x198 */ Vtx* questVtx;
-    /* 0x19C */ Vtx* maskVtx;
-    /* 0x1A0 */ Vtx* promptPageVtx;
-    /* 0x1A4 */ Vtx* infoPanelVtx;
-    /* 0x1A8 */ Vtx* cursorVtx;
-    /* 0x1AC */ OcarinaStaff* ocarinaStaff;
-    /* 0x1B0 */ UNK_TYPE1 unk_1B0[0x20];
-    /* 0x1D0 */ OSMesgQueue loadQueue;
-    /* 0x1E8 */ OSMesg loadMsg;
-    /* 0x1EC */ u16 state;
-    /* 0x1EE */ u16 debugEditor;
-    /* 0x1F0 */ u8 bombersNotebookOpen;
-    /* 0x1F4 */ Vec3f eye;
-    /* 0x200 */ u16 mainState;
-    /* 0x202 */ u16 nextPageMode; // (2 * prev pageIndex) + (scroll left ? 1 : 0)
-    /* 0x204 */ u16 pageIndex;
-    /* 0x206 */ u16 switchPageTimer;
-    /* 0x208 */ u16 savePromptState;
-    /* 0x20C */ f32 unk_20C; // set to 936.0f, unused remnant from OoT
-    /* 0x210 */ f32 itemPageRoll; // rotation (-z) of the item page into the screen
-    /* 0x214 */ f32 mapPageRoll; // rotation (+x) of the map page into the screen
-    /* 0x218 */ f32 questPageRoll; // rotation (+z) of the quest page into the screen
-    /* 0x21C */ f32 maskPageRoll; // rotation (-z) of the mask page into the screen
-    /* 0x220 */ f32 roll;
-    /* 0x224 */ u16 alpha;
-    /* 0x226 */ s16 offsetY;
-    /* 0x228 */ UNK_TYPE1 unk_228[0x8];
-    /* 0x230 */ s32 stickAdjX;
-    /* 0x234 */ s32 stickAdjY;
-    /* 0x238 */ s16 cursorPoint[5];
-    /* 0x242 */ s16 cursorXIndex[5];
-    /* 0x24C */ s16 cursorYIndex[5];
-    /* 0x256 */ s16 unk_256; // Uses DungeonItem enum
-    /* 0x258 */ s16 cursorSpecialPos;
-    /* 0x25A */ s16 pageSwitchInputTimer; // Used to introduce a delay before switching page when arriving on the "scroll left/right" positions while holding stick left/right.
-    /* 0x25C */ u16 namedItem;
-    /* 0x25E */ u16 cursorItem[5];
-    /* 0x268 */ u16 cursorSlot[5];
-    /* 0x272 */ u16 equipTargetItem;
-    /* 0x274 */ u16 equipTargetSlot;
-    /* 0x276 */ u16 equipTargetCBtn;
-    /* 0x278 */ s16 equipAnimX;
-    /* 0x27A */ s16 equipAnimY;
-    /* 0x27C */ s16 equipAnimAlpha;
-    /* 0x27E */ s16 infoPanelOffsetY;
-    /* 0x280 */ u16 nameDisplayTimer;
-    /* 0x282 */ u16 nameColorSet;
-    /* 0x284 */ s16 cursorColorSet;
-    /* 0x286 */ s16 cursorSpinPhase;
-    /* 0x288 */ f32 cursorX;
-    /* 0x28C */ f32 cursorY;
-    /* 0x290 */ f32 cursorWidth;
-    /* 0x294 */ f32 cursorHeight;
-    /* 0x298 */ f32 cursorShrinkRate;
-    /* 0x29C */ s16 promptChoice; // save/continue choice: 0 = yes; 4 = no
-    /* 0x29E */ s16 promptAlpha;
-    /* 0x2A0 */ s16 ocarinaSongIndex;
-    /* 0x2A2 */ u8 worldMapPoints[20];
-    /* 0x2B6 */ u8 unk_2B6; // unused red?
-    /* 0x2B7 */ u8 unk_2B7; // unused green?
-    /* 0x2B8 */ u8 unk_2B8; // unused blue?
-    /* 0x2B9 */ u8 itemDescriptionOn; // helpful description of item given through a message box
-    /* 0x2BA */ s16 equipAnimScale; // scale of item icon while moving being equipped to c-button
-    /* 0x2BC */ s16 equipAnimShrinkRate; // rate the scale is shrinking for the item icon while moving being equipped to c-button
-    /* 0x2BE */ s16 ocarinaButtonsY[5];
-    /* 0x2C8 */ u16 unk_2C8; // Uses PauseMenuPage enum for Owl Warp. Never set.
-    /* 0x2CA */ s16 unk_2CA; // Uses OwlWarpId enum for Owl Warp. Never set.
-} PauseContext; // size = 0x2D0
-
-typedef struct {
-    /* 0x00 */ void* loadedRamAddr;
-    /* 0x04 */ uintptr_t vromStart;
-    /* 0x08 */ uintptr_t vromEnd;
-    /* 0x0C */ void* vramStart;
-    /* 0x10 */ void* vramEnd;
-    /* 0x14 */ uintptr_t offset; // loadedRamAddr - vramStart
-    /* 0x18 */ const char* name;
-} KaleidoMgrOverlay; // size = 0x1C
-
-typedef enum {
-    /* 0x00 */ KALEIDO_OVL_KALEIDO_SCOPE,
-    /* 0x01 */ KALEIDO_OVL_PLAYER_ACTOR,
-    /* 0x02 */ KALEID_OVL_MAX
-} KaleidoMgrOverlayType;
-
 typedef struct {
     /* 0x0 */ u8   seqId;
     /* 0x1 */ u8   ambienceId;
diff --git a/include/z64pause_menu.h b/include/z64pause_menu.h
new file mode 100644
index 000000000..ec69f1734
--- /dev/null
+++ b/include/z64pause_menu.h
@@ -0,0 +1,248 @@
+#ifndef Z64PAUSE_MENU_H
+#define Z64PAUSE_MENU_H
+
+#include "ultra64.h"
+#include "z64math.h"
+#include "z64view.h"
+#include "unk.h"
+
+struct OcarinaStaff;
+struct PlayState;
+
+typedef enum PauseMenuPage {
+    /* 0 */ PAUSE_ITEM,
+    /* 1 */ PAUSE_MAP,
+    /* 2 */ PAUSE_QUEST,
+    /* 3 */ PAUSE_MASK,
+    /* 4 */ PAUSE_WORLD_MAP,
+    /* 5 */ PAUSE_PAGE_MAX
+} PauseMenuPage;
+
+typedef enum PauseState {
+    /* 0x00 */ PAUSE_STATE_OFF,
+    /* 0x01 */ PAUSE_STATE_OPENING_0,
+    /* 0x02 */ PAUSE_STATE_OPENING_1,
+    /* 0x03 */ PAUSE_STATE_OPENING_2,
+    /* 0x04 */ PAUSE_STATE_OPENING_3,
+    /* 0x05 */ PAUSE_STATE_OPENING_4,
+    /* 0x06 */ PAUSE_STATE_MAIN, // Pause menu ready for player inputs.
+    /* 0x07 */ PAUSE_STATE_SAVEPROMPT,
+    /* 0x08 */ PAUSE_STATE_GAMEOVER_0,
+    /* 0x09 */ PAUSE_STATE_GAMEOVER_1,
+    /* 0x0A */ PAUSE_STATE_GAMEOVER_2,
+    /* 0x0B */ PAUSE_STATE_GAMEOVER_3,
+    /* 0x0C */ PAUSE_STATE_GAMEOVER_4,
+    /* 0x0D */ PAUSE_STATE_GAMEOVER_5,
+    /* 0x0E */ PAUSE_STATE_GAMEOVER_SAVE_PROMPT,
+    /* 0x0F */ PAUSE_STATE_GAMEOVER_7,
+    /* 0x10 */ PAUSE_STATE_GAMEOVER_8,
+    /* 0x11 */ PAUSE_STATE_GAMEOVER_CONTINUE_PROMPT,
+    /* 0x12 */ PAUSE_STATE_GAMEOVER_10,
+    /* 0x13 */ PAUSE_STATE_OWL_WARP_0,
+    /* 0x14 */ PAUSE_STATE_OWL_WARP_1,
+    /* 0x15 */ PAUSE_STATE_OWL_WARP_2,
+    /* 0x16 */ PAUSE_STATE_OWL_WARP_3,
+    /* 0x17 */ PAUSE_STATE_OWL_WARP_SELECT, // Selecting the destination
+    /* 0x18 */ PAUSE_STATE_OWL_WARP_CONFIRM, // Confirming the choice given
+    /* 0x19 */ PAUSE_STATE_OWL_WARP_6,
+    /* 0x1A */ PAUSE_STATE_UNPAUSE_SETUP, // Unpause
+    /* 0x1B */ PAUSE_STATE_UNPAUSE_CLOSE
+} PauseState;
+
+typedef enum PauseMainState {
+    /* 0x00 */ PAUSE_MAIN_STATE_IDLE, // Await input for the next action
+    /* 0x01 */ PAUSE_MAIN_STATE_SWITCHING_PAGE,
+    /* 0x02 */ PAUSE_MAIN_STATE_SONG_PLAYBACK,
+    /* 0x03 */ PAUSE_MAIN_STATE_EQUIP_ITEM,
+    /* 0x04 */ PAUSE_MAIN_STATE_SONG_PROMPT_INIT,
+    /* 0x05 */ PAUSE_MAIN_STATE_SONG_PROMPT,
+    /* 0x06 */ PAUSE_MAIN_STATE_SONG_PROMPT_DONE,
+    /* 0x07 */ PAUSE_MAIN_STATE_SONG_PROMPT_UNUSED,
+    /* 0x08 */ PAUSE_MAIN_STATE_IDLE_CURSOR_ON_SONG, // Await input but the cursor is on a song
+    /* 0x09 */ PAUSE_MAIN_STATE_SONG_PLAYBACK_INIT,
+    /* 0x0F */ PAUSE_MAIN_STATE_EQUIP_MASK = 0xF,
+    /* 0x10 */ PAUSE_MAIN_STATE_BOMBERS_NOTEBOOK_OPEN,
+    /* 0x11 */ PAUSE_MAIN_STATE_UNK
+} PauseMainState;
+
+typedef enum PauseSavePromptState {
+    /* 0x00 */ PAUSE_SAVEPROMPT_STATE_APPEARING,
+    /* 0x01 */ PAUSE_SAVEPROMPT_STATE_1,
+    /* 0x02 */ PAUSE_SAVEPROMPT_STATE_RETURN_TO_MENU,
+    /* 0x03 */ PAUSE_SAVEPROMPT_STATE_3,
+    /* 0x04 */ PAUSE_SAVEPROMPT_STATE_4,
+    /* 0x05 */ PAUSE_SAVEPROMPT_STATE_5,
+    /* 0x06 */ PAUSE_SAVEPROMPT_STATE_6,
+    /* 0x07 */ PAUSE_SAVEPROMPT_STATE_7
+} PauseSavePromptState;
+
+typedef enum DebugEditor {
+    /* 0 */ DEBUG_EDITOR_NONE,
+    /* 1 */ DEBUG_EDITOR_INVENTORY_INIT,
+    /* 2 */ DEBUG_EDITOR_INVENTORY,
+    /* 3 */ DEBUG_EDITOR_EVENTS
+} DebugEditor;
+
+typedef enum PauseBgPreRenderState {
+    /* 0 */ PAUSE_BG_PRERENDER_OFF,
+    /* 1 */ PAUSE_BG_PRERENDER_SETUP, // The current frame is only drawn for the purpose of serving as the pause background.
+    /* 2 */ PAUSE_BG_PRERENDER_PROCESS, // The previous frame was PAUSE_BG_PRERENDER_DRAW, now apply prerender filters.
+    /* 3 */ PAUSE_BG_PRERENDER_READY, // The pause background is ready to be used.
+    /* 4 */ PAUSE_BG_PRERENDER_UNK4,
+    /* 5 */ PAUSE_BG_PRERENDER_MAX
+} PauseBgPreRenderState;
+
+typedef struct PauseContext {
+    /* 0x000 */ View view;
+    /* 0x168 */ u8* iconItemSegment;
+    /* 0x16C */ u8* iconItem24Segment;
+    /* 0x170 */ u8* iconItemAltSegment;
+    /* 0x174 */ u8* iconItemLangSegment;
+    /* 0x178 */ u8* nameSegment;
+    /* 0x17C */ u8* iconItemVtxSegment;
+    /* 0x180 */ Vtx* itemPageVtx;
+    /* 0x184 */ Vtx* mapPageVtx;
+    /* 0x188 */ Vtx* questPageVtx;
+    /* 0x18C */ Vtx* maskPageVtx;
+    /* 0x190 */ Vtx* itemVtx;
+    /* 0x194 */ Vtx* mapVtx; // inferred
+    /* 0x198 */ Vtx* questVtx;
+    /* 0x19C */ Vtx* maskVtx;
+    /* 0x1A0 */ Vtx* promptPageVtx;
+    /* 0x1A4 */ Vtx* infoPanelVtx;
+    /* 0x1A8 */ Vtx* cursorVtx;
+    /* 0x1AC */ struct OcarinaStaff* ocarinaStaff;
+    /* 0x1B0 */ UNK_TYPE1 unk_1B0[0x20];
+    /* 0x1D0 */ OSMesgQueue loadQueue;
+    /* 0x1E8 */ OSMesg loadMsg;
+    /* 0x1EC */ u16 state; // PauseState enum
+    /* 0x1EE */ u16 debugEditor; // DebugEditor enum
+    /* 0x1F0 */ u8 bombersNotebookOpen;
+    /* 0x1F4 */ Vec3f eye;
+    /* 0x200 */ u16 mainState; // PauseMainState enum
+    /* 0x202 */ u16 nextPageMode; // (2 * prev pageIndex) + (scroll left ? 1 : 0)
+    /* 0x204 */ u16 pageIndex; // PauseMenuPage enum
+    /* 0x206 */ u16 switchPageTimer;
+    /* 0x208 */ u16 savePromptState; // PauseSavePromptState enum
+    /* 0x20C */ f32 unk_20C; // set to 936.0f, unused remnant from OoT
+    /* 0x210 */ f32 itemPageRoll; // rotation (-z) of the item page into the screen
+    /* 0x214 */ f32 mapPageRoll; // rotation (+x) of the map page into the screen
+    /* 0x218 */ f32 questPageRoll; // rotation (+z) of the quest page into the screen
+    /* 0x21C */ f32 maskPageRoll; // rotation (-z) of the mask page into the screen
+    /* 0x220 */ f32 roll;
+    /* 0x224 */ u16 alpha;
+    /* 0x226 */ s16 offsetY;
+    /* 0x228 */ UNK_TYPE1 unk_228[0x8];
+    /* 0x230 */ s32 stickAdjX;
+    /* 0x234 */ s32 stickAdjY;
+    /* 0x238 */ s16 cursorPoint[PAUSE_PAGE_MAX]; // indexed by PauseMenuPage enum
+    /* 0x242 */ s16 cursorXIndex[PAUSE_PAGE_MAX]; // indexed by PauseMenuPage enum
+    /* 0x24C */ s16 cursorYIndex[PAUSE_PAGE_MAX]; // indexed by PauseMenuPage enum
+    /* 0x256 */ s16 unk_256; // Uses DungeonItem enum
+    /* 0x258 */ s16 cursorSpecialPos;
+    /* 0x25A */ s16 pageSwitchInputTimer; // Used to introduce a delay before switching page when arriving on the "scroll left/right" positions while holding stick left/right.
+    /* 0x25C */ u16 namedItem;
+    /* 0x25E */ u16 cursorItem[PAUSE_PAGE_MAX]; // indexed by PauseMenuPage enum
+    /* 0x268 */ u16 cursorSlot[PAUSE_PAGE_MAX]; // indexed by PauseMenuPage enum
+    /* 0x272 */ u16 equipTargetItem;
+    /* 0x274 */ u16 equipTargetSlot;
+    /* 0x276 */ u16 equipTargetCBtn; // PauseEquipCButton enum
+    /* 0x278 */ s16 equipAnimX;
+    /* 0x27A */ s16 equipAnimY;
+    /* 0x27C */ s16 equipAnimAlpha;
+    /* 0x27E */ s16 infoPanelOffsetY;
+    /* 0x280 */ u16 nameDisplayTimer;
+    /* 0x282 */ u16 nameColorSet;
+    /* 0x284 */ s16 cursorColorSet;
+    /* 0x286 */ s16 cursorSpinPhase;
+    /* 0x288 */ f32 cursorX;
+    /* 0x28C */ f32 cursorY;
+    /* 0x290 */ f32 cursorWidth;
+    /* 0x294 */ f32 cursorHeight;
+    /* 0x298 */ f32 cursorShrinkRate;
+    /* 0x29C */ s16 promptChoice; // save/continue choice: 0 = yes; 4 = no
+    /* 0x29E */ s16 promptAlpha;
+    /* 0x2A0 */ s16 ocarinaSongIndex;
+    /* 0x2A2 */ u8 worldMapPoints[20];
+    /* 0x2B6 */ u8 unk_2B6; // unused red?
+    /* 0x2B7 */ u8 unk_2B7; // unused green?
+    /* 0x2B8 */ u8 unk_2B8; // unused blue?
+    /* 0x2B9 */ u8 itemDescriptionOn; // helpful description of item given through a message box
+    /* 0x2BA */ s16 equipAnimScale; // scale of item icon while moving being equipped to c-button
+    /* 0x2BC */ s16 equipAnimShrinkRate; // rate the scale is shrinking for the item icon while moving being equipped to c-button
+    /* 0x2BE */ s16 ocarinaButtonsY[5];
+    /* 0x2C8 */ u16 unk_2C8; // Uses PauseMenuPage enum for Owl Warp. Never set.
+    /* 0x2CA */ s16 unk_2CA; // Uses OwlWarpId enum for Owl Warp. Never set.
+} PauseContext; // size = 0x2D0
+
+#define IS_PAUSE_STATE_GAMEOVER(pauseCtx) \
+    (((pauseCtx)->state >= PAUSE_STATE_GAMEOVER_0) && ((pauseCtx)->state <= PAUSE_STATE_GAMEOVER_10))
+
+#define IS_PAUSE_STATE_OWL_WARP(pauseCtx) \
+    (((pauseCtx)->state >= PAUSE_STATE_OWL_WARP_2) && ((pauseCtx)->state <= PAUSE_STATE_OWL_WARP_6))
+
+#define IS_PAUSE_MAIN_STATE_SONG_PROMPT(pauseCtx) \
+    (((pauseCtx)->mainState >= PAUSE_MAIN_STATE_SONG_PROMPT_INIT) && \
+     ((pauseCtx)->mainState <= PAUSE_MAIN_STATE_SONG_PROMPT_DONE))
+
+#define IS_PAUSED(pauseCtx) \
+    (((pauseCtx)->state != PAUSE_STATE_OFF) || ((pauseCtx)->debugEditor != DEBUG_EDITOR_NONE))
+
+
+typedef enum KaleidoMgrOverlayType {
+    /* 0 */ KALEIDO_OVL_KALEIDO_SCOPE,
+    /* 1 */ KALEIDO_OVL_PLAYER_ACTOR,
+    /* 2 */ KALEIDO_OVL_MAX
+} KaleidoMgrOverlayType;
+
+typedef struct KaleidoMgrOverlay {
+    /* 0x00 */ void* loadedRamAddr;
+    /* 0x04 */ uintptr_t vromStart;
+    /* 0x08 */ uintptr_t vromEnd;
+    /* 0x0C */ void* vramStart;
+    /* 0x10 */ void* vramEnd;
+    /* 0x14 */ uintptr_t offset; // loadedRamAddr - vramStart
+    /* 0x18 */ const char* name;
+} KaleidoMgrOverlay; // size = 0x1C
+
+
+// z_kaleido_setup.c
+
+void func_800F4A10(struct PlayState* play);
+void KaleidoSetup_Update(struct PlayState* play);
+void KaleidoSetup_Init(struct PlayState* play);
+void KaleidoSetup_Destroy(struct PlayState* play);
+
+
+// z_kaleido_manager.c
+
+void KaleidoManager_LoadOvl(KaleidoMgrOverlay* ovl);
+void KaleidoManager_ClearOvl(KaleidoMgrOverlay* ovl);
+void KaleidoManager_Init(struct PlayState* play);
+void KaleidoManager_Destroy(void);
+void* KaleidoManager_GetRamAddr(void* vram);
+
+extern KaleidoMgrOverlay gKaleidoMgrOverlayTable[KALEIDO_OVL_MAX];
+extern KaleidoMgrOverlay* gKaleidoMgrCurOvl;
+
+
+// z_kaleido_scope_call.c
+
+void KaleidoScopeCall_LoadPlayer(void);
+void KaleidoScopeCall_Init(struct PlayState* play);
+void KaleidoScopeCall_Destroy(struct PlayState* play);
+void KaleidoScopeCall_Update(struct PlayState* play);
+void KaleidoScopeCall_Draw(struct PlayState* play);
+
+
+// Item macros
+
+#define ITEM_GRID_ROWS 4
+#define ITEM_GRID_COLS 6
+#define MASK_GRID_ROWS 4
+#define MASK_GRID_COLS 6
+
+#define ITEM_NUM_SLOTS (ITEM_GRID_ROWS * ITEM_GRID_COLS)
+#define MASK_NUM_SLOTS (MASK_GRID_ROWS * MASK_GRID_COLS)
+
+#endif
diff --git a/include/z64view.h b/include/z64view.h
index 19bb4492c..92375e158 100644
--- a/include/z64view.h
+++ b/include/z64view.h
@@ -3,6 +3,7 @@
 
 #include "PR/ultratypes.h"
 #include "PR/gbi.h"
+#include "main.h"
 #include "z64math.h"
 #include "unk.h"