THA docs (#1177)

* THA docs

Co-authored-by: Tharo <17233964+Thar0@users.noreply.github.com>

* format

* namefixer

* yada

* remove zero pad comment

* Update include/z64.h

Co-authored-by: engineer124 <47598039+engineer124@users.noreply.github.com>

* Update include/thga.h

Co-authored-by: engineer124 <47598039+engineer124@users.noreply.github.com>

* namefixer

* bss

* namefixer

---------

Co-authored-by: Tharo <17233964+Thar0@users.noreply.github.com>
Co-authored-by: engineer124 <47598039+engineer124@users.noreply.github.com>

tools/disasm/functions.txt

@@ -3080,35 +3080,35 @@
     0x801720C4:("func_801720C4",),
     0x801720FC:("func_801720FC",),
     0x80172758:("Prerender_DrawBackground2D",),
-    0x801727F0:("THGA_Ct",),
-    0x80172810:("THGA_Dt",),
+    0x801727F0:("THGA_Init",),
+    0x80172810:("THGA_Destroy",),
     0x80172830:("THGA_IsCrash",),
     0x80172850:("THGA_Init",),
-    0x80172870:("THGA_GetSize",),
+    0x80172870:("THGA_GetRemaining",),
     0x80172890:("THGA_GetHead",),
     0x801728B0:("THGA_SetHead",),
     0x801728D0:("THGA_GetTail",),
-    0x801728F0:("THGA_AllocStartArray8",),
-    0x80172914:("THGA_AllocStart8",),
-    0x80172934:("THGA_AllocStart8Wrapper",),
-    0x80172954:("THGA_AllocEnd",),
-    0x80172974:("THGA_AllocEndArray64",),
-    0x80172998:("THGA_AllocEnd64",),
-    0x801729B8:("THGA_AllocEndArray16",),
-    0x801729DC:("THGA_AllocEnd16",),
+    0x801728F0:("THGA_AllocDisplayList",),
+    0x80172914:("THGA_AllocGfx",),
+    0x80172934:("THGA_AllocGfx2",),
+    0x80172954:("THGA_AllocTail",),
+    0x80172974:("THGA_AllocMtxArray",),
+    0x80172998:("THGA_AllocMtx",),
+    0x801729B8:("THGA_AllocVtxArray",),
+    0x801729DC:("THGA_AllocVtx",),
     0x80172A00:("THA_GetHead",),
     0x80172A0C:("THA_SetHead",),
     0x80172A18:("THA_GetTail",),
-    0x80172A24:("THA_AllocStart",),
-    0x80172A38:("THA_AllocStart1",),
-    0x80172A58:("THA_AllocEnd",),
-    0x80172AC8:("THA_AllocEndAlign16",),
-    0x80172AE8:("THA_AllocEndAlign",),
-    0x80172B04:("THA_GetSize",),
+    0x80172A24:("THA_AllocHead",),
+    0x80172A38:("THA_AllocHeadByte",),
+    0x80172A58:("THA_AllocTail",),
+    0x80172AC8:("THA_AllocTailAlign16",),
+    0x80172AE8:("THA_AllocTailAlign",),
+    0x80172B04:("THA_GetRemaining",),
     0x80172B18:("THA_IsCrash",),
-    0x80172B3C:("THA_Init",),
-    0x80172B58:("THA_Ct",),
-    0x80172B9C:("THA_Dt",),
+    0x80172B3C:("THA_Reset",),
+    0x80172B58:("THA_Init",),
+    0x80172B9C:("THA_Destroy",),
     0x80172BC0:("AudioMgr_StopAllSfxExceptSystem",),
     0x80172C30:("func_80172C30",),
     0x80172C68:("AudioMgr_HandleRetrace",),

tools/namefixer.py

@@ -117,6 +117,23 @@ wordReplace = {
     "Actor_MarkForDeath": "Actor_Kill",
     "func_800B84D0": "Actor_ProcessTalkRequest",
     "func_8017D668": "Math3D_PointDistToLine2D",
+
+    "THGA_GetSize": "THGA_GetRemaining",
+    "THGA_AllocStartArray8": "THGA_AllocDisplayList",
+    "THGA_AllocStart8": "THGA_AllocGfx",
+    "THGA_AllocStart8Wrapper": "THGA_AllocGfx2",
+    "THGA_AllocEnd": "THGA_AllocTail",
+    "THGA_AllocEndArray64": "THGA_AllocMtxArray",
+    "THGA_AllocEnd64": "THGA_AllocMtx",
+    "THGA_AllocEndArray16": "THGA_AllocVtxArray",
+    "THGA_AllocEnd16": "THGA_AllocVtx",
+    "THA_AllocStart": "THA_AllocHead",
+    "THA_AllocStart1": "THA_AllocHeadByte",
+    "THA_AllocEnd": "THA_AllocTail",
+    "THA_AllocEndAlign16": "THA_AllocTailAlign16",
+    "THA_AllocEndAlign": "THA_AllocTailAlign",
+    "THA_GetSize": "THA_GetRemaining",
+
     "func_800BDFC0": "Gfx_DrawDListOpa",
     "func_800BE03C": "Gfx_DrawDListXlu",
     "func_800B6FC8": "Player_GetHeight",

tools/sizes/code_functions.csv

@@ -2594,35 +2594,35 @@ asm/non_matchings/code/PreRender/PreRender_ApplyFiltersSlowlyDestroy.s,PreRender
 asm/non_matchings/code/PreRender/func_801720C4.s,func_801720C4,0x801720C4,0xE
 asm/non_matchings/code/PreRender/func_801720FC.s,func_801720FC,0x801720FC,0x197
 asm/non_matchings/code/PreRender/Prerender_DrawBackground2D.s,Prerender_DrawBackground2D,0x80172758,0x26
-asm/non_matchings/code/TwoHeadGfxArena/THGA_Ct.s,THGA_Ct,0x801727F0,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_Dt.s,THGA_Dt,0x80172810,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_Init.s,THGA_Init,0x801727F0,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_Destroy.s,THGA_Destroy,0x80172810,0x8
 asm/non_matchings/code/TwoHeadGfxArena/THGA_IsCrash.s,THGA_IsCrash,0x80172830,0x8
 asm/non_matchings/code/TwoHeadGfxArena/THGA_Init.s,THGA_Init,0x80172850,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_GetSize.s,THGA_GetSize,0x80172870,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_GetRemaining.s,THGA_GetRemaining,0x80172870,0x8
 asm/non_matchings/code/TwoHeadGfxArena/THGA_GetHead.s,THGA_GetHead,0x80172890,0x8
 asm/non_matchings/code/TwoHeadGfxArena/THGA_SetHead.s,THGA_SetHead,0x801728B0,0x8
 asm/non_matchings/code/TwoHeadGfxArena/THGA_GetTail.s,THGA_GetTail,0x801728D0,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocStartArray8.s,THGA_AllocStartArray8,0x801728F0,0x9
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocStart8.s,THGA_AllocStart8,0x80172914,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocStart8Wrapper.s,THGA_AllocStart8Wrapper,0x80172934,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocEnd.s,THGA_AllocEnd,0x80172954,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocEndArray64.s,THGA_AllocEndArray64,0x80172974,0x9
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocEnd64.s,THGA_AllocEnd64,0x80172998,0x8
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocEndArray16.s,THGA_AllocEndArray16,0x801729B8,0x9
-asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocEnd16.s,THGA_AllocEnd16,0x801729DC,0x9
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocDisplayList.s,THGA_AllocDisplayList,0x801728F0,0x9
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocGfx.s,THGA_AllocGfx,0x80172914,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocGfx2.s,THGA_AllocGfx2,0x80172934,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocTail.s,THGA_AllocTail,0x80172954,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocMtxArray.s,THGA_AllocMtxArray,0x80172974,0x9
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocMtx.s,THGA_AllocMtx,0x80172998,0x8
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocVtxArray.s,THGA_AllocVtxArray,0x801729B8,0x9
+asm/non_matchings/code/TwoHeadGfxArena/THGA_AllocVtx.s,THGA_AllocVtx,0x801729DC,0x9
 asm/non_matchings/code/TwoHeadArena/THA_GetHead.s,THA_GetHead,0x80172A00,0x3
 asm/non_matchings/code/TwoHeadArena/THA_SetHead.s,THA_SetHead,0x80172A0C,0x3
 asm/non_matchings/code/TwoHeadArena/THA_GetTail.s,THA_GetTail,0x80172A18,0x3
-asm/non_matchings/code/TwoHeadArena/THA_AllocStart.s,THA_AllocStart,0x80172A24,0x5
-asm/non_matchings/code/TwoHeadArena/THA_AllocStart1.s,THA_AllocStart1,0x80172A38,0x8
-asm/non_matchings/code/TwoHeadArena/THA_AllocEnd.s,THA_AllocEnd,0x80172A58,0x1C
-asm/non_matchings/code/TwoHeadArena/THA_AllocEndAlign16.s,THA_AllocEndAlign16,0x80172AC8,0x8
-asm/non_matchings/code/TwoHeadArena/THA_AllocEndAlign.s,THA_AllocEndAlign,0x80172AE8,0x7
-asm/non_matchings/code/TwoHeadArena/THA_GetSize.s,THA_GetSize,0x80172B04,0x5
+asm/non_matchings/code/TwoHeadArena/THA_AllocHead.s,THA_AllocHead,0x80172A24,0x5
+asm/non_matchings/code/TwoHeadArena/THA_AllocHeadByte.s,THA_AllocHeadByte,0x80172A38,0x8
+asm/non_matchings/code/TwoHeadArena/THA_AllocTail.s,THA_AllocTail,0x80172A58,0x1C
+asm/non_matchings/code/TwoHeadArena/THA_AllocTailAlign16.s,THA_AllocTailAlign16,0x80172AC8,0x8
+asm/non_matchings/code/TwoHeadArena/THA_AllocTailAlign.s,THA_AllocTailAlign,0x80172AE8,0x7
+asm/non_matchings/code/TwoHeadArena/THA_GetRemaining.s,THA_GetRemaining,0x80172B04,0x5
 asm/non_matchings/code/TwoHeadArena/THA_IsCrash.s,THA_IsCrash,0x80172B18,0x9
-asm/non_matchings/code/TwoHeadArena/THA_Init.s,THA_Init,0x80172B3C,0x7
-asm/non_matchings/code/TwoHeadArena/THA_Ct.s,THA_Ct,0x80172B58,0x11
-asm/non_matchings/code/TwoHeadArena/THA_Dt.s,THA_Dt,0x80172B9C,0x9
+asm/non_matchings/code/TwoHeadArena/THA_Reset.s,THA_Reset,0x80172B3C,0x7
+asm/non_matchings/code/TwoHeadArena/THA_Init.s,THA_Init,0x80172B58,0x11
+asm/non_matchings/code/TwoHeadArena/THA_Destroy.s,THA_Destroy,0x80172B9C,0x9
 asm/non_matchings/code/audio_stop_all_sfx/AudioMgr_StopAllSfxExceptSystem.s,AudioMgr_StopAllSfxExceptSystem,0x80172BC0,0x1C
 asm/non_matchings/code/audio_thread_manager/func_80172C30.s,func_80172C30,0x80172C30,0xE
 asm/non_matchings/code/audio_thread_manager/AudioMgr_HandleRetrace.s,AudioMgr_HandleRetrace,0x80172C68,0x91