From dc2ceb33f31fd26aa35f5fddbda0eeedd3297bb3 Mon Sep 17 00:00:00 2001
From: Dragorn421 <Dragorn421@users.noreply.github.com>
Date: Wed, 18 Sep 2024 14:11:21 +0200
Subject: Pause doc: Pages drawing (#2190)

* name main fields and regs for pages drawing

* comments

* format

* more comments

* roll -> pitch (oops)

* Document `PauseContext.offsetY`, `R_PAUSE_OFFSET_VERTICAL` as "y origin 1/2"

* copypaste comment on page pitches fields

* "offset depth" -> "depth offset"

* review
---
 src/code/z_construct.c     | 4 ++--
 src/code/z_kaleido_setup.c | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

(limited to 'src/code')

diff --git a/src/code/z_construct.c b/src/code/z_construct.c
index 104b048fd..7041ac230 100644
--- a/src/code/z_construct.c
+++ b/src/code/z_construct.c
@@ -494,8 +494,8 @@ void Regs_InitDataImpl(void) {
     XREG(93) = 100;
     XREG(94) = 160;
     XREG(95) = 200;
-    WREG(2) = -6080;
-    WREG(3) = 9355;
+    R_PAUSE_PAGES_Y_ORIGIN_2 = -6080;
+    R_PAUSE_DEPTH_OFFSET = 9355;
     WREG(4) = 8;
     WREG(5) = 3;
     WREG(6) = 8;
diff --git a/src/code/z_kaleido_setup.c b/src/code/z_kaleido_setup.c
index 1e5407165..1079cd083 100644
--- a/src/code/z_kaleido_setup.c
+++ b/src/code/z_kaleido_setup.c
@@ -112,7 +112,7 @@ void KaleidoSetup_Update(PlayState* play) {
         }
 
         if (pauseCtx->state == PAUSE_STATE_WAIT_LETTERBOX) {
-            WREG(2) = -6240;
+            R_PAUSE_PAGES_Y_ORIGIN_2 = PAUSE_PAGES_Y_ORIGIN_2_LOWER;
             R_UPDATE_RATE = 2;
 
             if (Letterbox_GetSizeTarget() != 0) {
@@ -132,15 +132,15 @@ void KaleidoSetup_Init(PlayState* play) {
 
     pauseCtx->eye.x = pauseCtx->eye.y = 0.0f;
     pauseCtx->eye.z = 64.0f;
-    pauseCtx->unk_1F0 = 936.0f;
-    pauseCtx->unk_1F4 = pauseCtx->unk_1F8 = pauseCtx->unk_1FC = pauseCtx->unk_200 = 160.0f;
+    pauseCtx->promptDepthOffset = 936.0f;
+    pauseCtx->itemPagePitch = pauseCtx->equipPagePitch = pauseCtx->mapPagePitch = pauseCtx->questPagePitch = 160.0f;
 
     pauseCtx->alpha = 0;
 
     // mainState = PAUSE_MAIN_STATE_IDLE , pageIndex = PAUSE_ITEM
     pauseCtx->pageSwitchTimer = pauseCtx->mainState = pauseCtx->nextPageMode = pauseCtx->pageIndex = 0;
 
-    pauseCtx->unk_204 = -314.0f;
+    pauseCtx->promptPitch = -314.0f;
 
     pauseCtx->cursorPoint[PAUSE_ITEM] = 0;
     pauseCtx->cursorPoint[PAUSE_MAP] = VREG(30) + 3;
-- 
cgit v1.2.3