pmdsky-debug-py 7.0.8__py3-none-any.whl → 7.0.10__py3-none-any.whl

pmdsky_debug_py/na.py

@@ -53,11 +53,13 @@ class NaArm9Functions:
         None,
         "Sets global parameters for the memory allocator.\n\nThis includes"
         " MEMORY_ALLOCATION_ARENA_GETTERS and some other stuff.\n\nDungeon mode uses"
-        " the default arena getters. Ground mode uses its own arena getters, which are"
-        " defined in overlay 11 and set (by calling this function) at the start of"
-        " GroundMainLoop.\n\nr0: GetAllocArena function pointer (GetAllocArenaDefault"
-        " is used if null)\nr1: GetFreeArena function pointer (GetFreeArenaDefault is"
-        " used if null)",
+        " the default arena getters. Ground mode uses its own arena getters that return"
+        " custom arenas for some flag values, which are defined in overlay 11 and set"
+        " (by calling this function) at the start of GroundMainLoop. Note that the"
+        " sound memory arena is provided explicitly to MemLocateSet in the sound code,"
+        " so doesn't go through this path.\n\nr0: GetAllocArena function pointer"
+        " (GetAllocArenaDefault is used if null)\nr1: GetFreeArena function pointer"
+        " (GetFreeArenaDefault is used if null)",
     )
 
     GetAllocArenaDefault = Symbol(
@@ -2377,6 +2379,21 @@ class NaArm9Functions:
         " command list'\n\nr0: Command to send",
     )
 
+    InitSoundSystem = Symbol(
+        [0x18C28],
+        [0x2018C28],
+        None,
+        "Initialize the DSE sound engine?\n\nThis function is called somewhere in the"
+        " hierarchy under TaskProcBoot and appears to allocate a bunch of memory"
+        " (including a dedicated memory arena, see SOUND_MEMORY_ARENA) for sound data,"
+        " and reads a bunch of core sound files.\n\nFile paths referenced:\n-"
+        " SOUND/SYSTEM/se_sys.swd\n- SOUND/SYSTEM/se_sys.sed\n- SOUND/SE/motion.swd\n-"
+        " SOUND/SE/motion.sed\n- SOUND/BGM/bgm.swd (this is the main sample bank, see"
+        " https://projectpokemon.org/home/docs/mystery-dungeon-nds/pok%C3%A9mon-mystery-dungeon-explorers-r78/)\n\nDebug"
+        " strings:\n- entry system se swd %04x\n\n- entry system se sed %04x\n\n- entry"
+        " motion se swd %04x\n\n- entry motion se sed %04x\n",
+    )
+
     ManipBgmPlayback = Symbol(
         [0x18EA4],
         [0x2018EA4],
@@ -2483,6 +2500,32 @@ class NaArm9Functions:
         " field 0x43 to 0xFF\n\nr0: animation control\nr1: sprite id in WAN_TABLE",
     )
 
+    SetAnimationForAnimationControlInternal = Symbol(
+        None,
+        None,
+        None,
+        "Set the wan animation (and other related settings) of an"
+        " animation_control\nUsed by SetAnimationForAnimationControl\n\nr0:"
+        " animation_control\nr1: wan_header\nr2: animation group id\nr3: animation"
+        " id\nstack[0]: ?\nstack[1] (0x4): palette pos low (see the field on"
+        " animation_control)\nstack[2] (0x8): ?\nstack[3] (0xC): ?\nstack[4] (0x10):"
+        " palette_bank (directly set to the animation_control field with said name)",
+    )
+
+    SetAnimationForAnimationControl = Symbol(
+        None,
+        None,
+        None,
+        "Set the animation to play with this animation control, but do not start"
+        " it.\n\n(args same as SetAndPlayAnimationForAnimationControl)\nr0:"
+        " animation_control\nr1: animation key (either an animation or animation group"
+        " depending on the type of sprite and if it does have animation group with this"
+        " animation key as index)\nr2: direction_id (unsure) (the key to the"
+        " wan_animation in itself, only used when animation key represent a"
+        " wan_animation_group)\nr3: ?\nstack[0]: low_palette_pos\nstack[1] (0x4):"
+        " ?\nstack[2] (0x8): ?\nstack[3] (0xC): ?",
+    )
+
     GetWanForAnimationControl = Symbol(
         None,
         None,
@@ -2492,6 +2535,19 @@ class NaArm9Functions:
         " animation_control\nreturn: wan_header",
     )
 
+    SetAndPlayAnimationForAnimationControl = Symbol(
+        None,
+        None,
+        None,
+        "Set the animation to play with the animation control, and start it.\n\nr0:"
+        " animation_control\nr1: animation key (either an animation or animation group"
+        " depending on the type of sprite and if it does have animation group with this"
+        " animation key as index)\nr2: direction_id (unsure) (the key to the"
+        " wan_animation in itself, only used when animation key represent a"
+        " wan_animation_group)\nr3: ?\nstack[0]: low_palette_pos\nstack[1] (0x4):"
+        " ?\nstack[2] (0x8): ?\nstack[3] (0xC): ?",
+    )
+
     SwitchAnimationControlToNextFrame = Symbol(
         None,
         None,
@@ -2681,6 +2737,60 @@ class NaArm9Functions:
         " unk_pal\nr2: unk_tex\nr3: unk_tex_param",
     )
 
+    GeomSetTexImageParam = Symbol(
+        None,
+        None,
+        None,
+        "Send the 'TEXIMAGE_PARAM' geometry engine command, that defines some"
+        " parameters for the texture\nSee"
+        " http://problemkaputt.de/gbatek.htm#ds3dtextureattributes for more information"
+        " on the parameters\n\nr0: texture format\nr1: texture coordinates"
+        " transformation modes\nr2: texture S-Size\nr3: texture T-Size\nstack[0] (0x0):"
+        " repeat in S Direction\nstack[1] (0x4): flip in S direction\nstack[2] (0x8):"
+        " What to make of color 0 (bit 29)\nstack[3] (0xC): Texture VRAM offset (Will"
+        " be divided by 8)",
+    )
+
+    GeomSetVertexCoord16 = Symbol(
+        None,
+        None,
+        None,
+        "Send the 'VTX_16' geometry engine command, that defines the coordinate of a"
+        " point of a polygon, using 16 bits.\nInputs are clamped over their 16 lower"
+        " bits\n\nr0: x coordinate\nr1: y coordinate\nr2: z coordinate",
+    )
+
+    InitRender3dData = Symbol(
+        None, None, None, "Initialize the global 'RENDER_3D' structure.\n\nNo params."
+    )
+
+    GeomSwapBuffers = Symbol(
+        None,
+        None,
+        None,
+        "Call the 'SWAP_BUFFERS' command. This will swap the geometry buffer. The"
+        " parameter of 1 is provided, which enables manual Y-sorting of translucent"
+        " polygons.\n\nNo params.",
+    )
+
+    InitRender3dElement = Symbol(
+        [0x1E730],
+        [0x201E730],
+        None,
+        "Initialize the render_3d_element structure (without performing any drawing or"
+        " external data access)\n\nr0: render_3d_element",
+    )
+
+    Generate3dCanvasBorder = Symbol(
+        None,
+        None,
+        None,
+        "Draw the border for dialogue box and other menus, using the 3D engine.\nThe"
+        " render_3d_element contains certain value that needs to be set to a correct"
+        " value for it to work.\nThe element is not immediately sent to the geometry"
+        " engine, but is queued up in RENDER_3D\n\nr0: render_3d_element",
+    )
+
     HandleSir0Translation = Symbol(
         [0x1F4B4],
         [0x201F4B4],
@@ -3549,7 +3659,13 @@ class NaArm9Functions:
         [0x4CA94],
         [0x204CA94],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: flag_id\nreturn: ?",
+        "Returns the value of one of the flags in VAR_PERFORMANCE_PROGRESS_LIST, with"
+        " some edge cases.\n\nList of cases where the function behaves differently:\n-"
+        " If the requested flag is 0, returns true if and only if SCENARIO_MAIN =="
+        " 0x35\n- If the requested flag is 1 or 2 and GAME_MODE =="
+        " GAME_MODE_SPECIAL_EPISODE, returns true\n- If the requested flag is between 3"
+        " and 7 (both included) and GAME_MODE == GAME_MODE_SPECIAL_EPISODE, returns"
+        " false\n\nr0: ID of the flag to get\nreturn: Value of the flag",
     )
 
     GetScenarioBalance = Symbol(
@@ -3997,7 +4113,8 @@ class NaArm9Functions:
         [0x204FC28],
         None,
         "Increments by 1 the number of dungeons cleared.\n\nImplements"
-        " SPECIAL_PROC_0x3A (see ScriptSpecialProcessCall).\n\nNo params.",
+        " SPECIAL_PROC_INCREMENT_DUNGEONS_CLEARED (see ScriptSpecialProcessCall).\n\nNo"
+        " params.",
     )
 
     GetNbDungeonsCleared = Symbol(
@@ -4111,7 +4228,8 @@ class NaArm9Functions:
         [0x204FEC8],
         None,
         "Increments by 1 the number of big treasure wins.\n\nImplements"
-        " SPECIAL_PROC_0x3B (see ScriptSpecialProcessCall).\n\nNo params.",
+        " SPECIAL_PROC_INCREMENT_BIG_TREASURE_WINS (see"
+        " ScriptSpecialProcessCall).\n\nNo params.",
     )
 
     SetNbBigTreasureWins = Symbol(
@@ -5854,11 +5972,33 @@ class NaArm9Functions:
         [0x70674], [0x2070674], None, "Note: unverified, ported from Irdkwia's notes"
     )
 
+    ParseDseEvents = Symbol(
+        [0x71224],
+        [0x2071224],
+        None,
+        "From https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/",
+    )
+
+    UpdateSequencerTracks = Symbol(
+        [0x713E8],
+        [0x20713E8],
+        None,
+        "From https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/",
+    )
+
     UpdateChannels = Symbol(
         [0x7448C],
         [0x207448C],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nNo params.",
+        "From https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/"
+        " and Irdkwia's notes.\n\nNo params.",
+    )
+
+    UpdateTrackVolumeEnvelopes = Symbol(
+        [0x74E0C],
+        [0x2074E0C],
+        None,
+        "From https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/",
     )
 
     EnableVramBanksInSetDontSave = Symbol(
@@ -7376,6 +7516,14 @@ class NaArm9Data:
         "pointer to the list of wan sprite loaded in RAM\n\nstruct wan_table*",
     )
 
+    RENDER_3D = Symbol(
+        None,
+        None,
+        None,
+        "The (seemingly) unique instance render_3d_global in the game\n\ntype: struct"
+        " render_3d_global",
+    )
+
     LANGUAGE_INFO_DATA = Symbol([0xAFCE8], [0x20AFCE8], None, "[Runtime]")
 
     TBL_TALK_GROUP_STRING_ID_START = Symbol(
@@ -7471,7 +7619,9 @@ class NaArm9Data:
         [0xB0B90],
         [0x20B0B90],
         0x1FC,
-        "Irdkwia's notes: named DSEEventFunctionPtrTable with length 0x3C0 (note the"
+        "Table of all DSE events, see"
+        " https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/\n\nIrdkwia's"
+        " notes: named DSEEventFunctionPtrTable with length 0x3C0 (note the"
         " disagreement), 240*0x4.",
     )
 
@@ -7523,6 +7673,24 @@ class NaArm9Section:
 
 
 class NaItcmFunctions:
+    AllocateRender3dElement = Symbol(
+        None,
+        None,
+        None,
+        "Return a new render_3d_element from RENDER_3D, to be to draw a new element"
+        " using the 3d render engine later in the frame.\n\nreturn: render_3d_element"
+        " or NULL if there is no more available space in the stack",
+    )
+
+    Render3dStack = Symbol(
+        None,
+        None,
+        None,
+        "Perform rendering of the render_stack of RENDER_3D structure. Does nothing if"
+        " there are no elements, otherwise, sort them based on a value, and render them"
+        " all consecutively.\n\nNo params.",
+    )
+
     GetKeyN2MSwitch = Symbol(
         [0x1434],
         [0x20B47B4],
@@ -7649,6 +7817,14 @@ class NaItcmData:
         " mem_block[256]",
     )
 
+    RENDER_3D_FUNCTIONS = Symbol(
+        None,
+        None,
+        None,
+        "Pointers to the 4 functions available from render_3d_element (in"
+        " ITCM)\n\ntype: render_3d_element_concrete[4]",
+    )
+
 
 class NaItcmSection:
     name = "itcm"
@@ -12096,8 +12272,10 @@ class NaOverlay11Functions:
         [0x22E935C],
         None,
         "The GetAllocArena function used for ground mode. See SetMemAllocatorParams for"
-        " more information.\n\nr0: initial memory arena pointer, or null\nr1: flags"
-        " (see MemAlloc)\nreturn: memory arena pointer, or null",
+        " more information.\n\nFor (flags & 0xFF):\n  8, 15, 16:"
+        " GROUND_MEMORY_ARENA_1\n  14: GROUND_MEMORY_ARENA_2\n  other: null (default"
+        " arena)\n\nr0: initial memory arena pointer, or null\nr1: flags (see"
+        " MemAlloc)\nreturn: memory arena pointer, or null",
     )
 
     GetFreeArenaGround = Symbol(
@@ -12490,6 +12668,8 @@ class NaOverlay11Data:
         " scene\n\ntype: struct main_ground_data",
     )
 
+    WORLD_MAP_MODE = Symbol([0x48BA4], [0x2324DE4], 0x4, "The current world map")
+
 
 class NaOverlay11Section:
     name = "overlay11"
@@ -19154,7 +19334,7 @@ class NaOverlay29Functions:
         [0x59748],
         [0x2335988],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: call_back_str\nr1: x"
+        "Note: unverified, ported from Irdkwia's notes\n\nr0: render_3d_element\nr1: x"
         " position\nr2: y position\nr3: char_id\nstack[0]: ?\nreturn: ?",
     )
 
@@ -22440,6 +22620,36 @@ class NaRamFunctions:
 
 
 class NaRamData:
+    DEFAULT_MEMORY_ARENA_MEMORY = Symbol(
+        [0xB4BC0],
+        [0x20B4BC0],
+        0x1E6400,
+        "The memory region for the default memory arena.\n\nThe length is defined by"
+        " DEFAULT_MEMORY_ARENA_SIZE.\n\nOne mode that uses this region for heap"
+        " allocations is dungeon mode.",
+    )
+
+    GROUND_MEMORY_ARENA_2 = Symbol(
+        [0x145A08],
+        [0x2145A08],
+        0x1C,
+        "This is a memory subarena under DEFAULT_MEMORY_ARENA used for some things in"
+        " ground mode.\n\nIt's used for user_flags 14.\n\nIncluding the allocator"
+        " metadata, this arena occupies 0xB0000 bytes of space.\n\ntype: struct"
+        " mem_arena",
+    )
+
+    GROUND_MEMORY_ARENA_2_BLOCKS = Symbol(
+        [0x145A24],
+        [0x2145A24],
+        0x300,
+        "The block array for GROUND_MEMORY_ARENA_2.\n\ntype: struct mem_block[32]",
+    )
+
+    GROUND_MEMORY_ARENA_2_MEMORY = Symbol(
+        [0x145D24], [0x2145D24], 0xAFCE4, "The memory region for GROUND_MEMORY_ARENA_2."
+    )
+
     DUNGEON_COLORMAP_PTR = Symbol(
         [0x1B9CF4],
         [0x21B9CF4],
@@ -22469,6 +22679,33 @@ class NaRamData:
         " ARM 9 binary.\n\ntype: struct move_data_table",
     )
 
+    SOUND_MEMORY_ARENA = Symbol(
+        [0x24EFA0],
+        [0x224EFA0],
+        0x1C,
+        "This is a memory subarena under DEFAULT_MEMORY_ARENA that seems to be used"
+        " exclusively for sound data.\n\nIncluding allocator metadata, this subarena"
+        " occupies 0x3C000 bytes of space within the default arena.\n\nIt's referenced"
+        " by various sound functions like LoadDseFile, PlaySeLoad, and PlayBgm when"
+        " allocating memory.\n\ntype: struct mem_arena",
+    )
+
+    SOUND_MEMORY_ARENA_BLOCKS = Symbol(
+        [0x24EFBC],
+        [0x224EFBC],
+        0x1E0,
+        "The block array for SOUND_MEMORY_ARENA.\n\ntype: struct mem_block[20]",
+    )
+
+    SOUND_MEMORY_ARENA_MEMORY = Symbol(
+        [0x24F19C],
+        [0x224F19C],
+        0x3BE04,
+        "The memory region for SOUND_MEMORY_ARENA.\n\nThis region appears to be used"
+        " for sound-related heap allocations, like when loading sound files into"
+        " memory.",
+    )
+
     FRAMES_SINCE_LAUNCH = Symbol(
         [0x2A354C, 0x2A359C],
         [0x22A354C, 0x22A359C],
@@ -22594,6 +22831,10 @@ class NaRamData:
         None, None, None, "animation_control of 'FONT/alter.wan'"
     )
 
+    SOUND_MEMORY_ARENA_PTR = Symbol(
+        [0x2A4E54], [0x22A4E54], 0x4, "Pointer to SOUND_MEMORY_ARENA."
+    )
+
     DIALOG_BOX_LIST = Symbol(
         [0x2A88DC], [0x22A88DC], None, "Array of allocated dialog box structs."
     )
@@ -22716,7 +22957,33 @@ class NaRamData:
         " the game is running.",
     )
 
-    WORLD_MAP_MODE = Symbol([0x324DE4], [0x2324DE4], 0x4, "The current world map")
+    GROUND_MEMORY_ARENA_1_PTR = Symbol(
+        [0x324CB4], [0x2324CB4], 0x4, "Pointer to GROUND_MEMORY_ARENA_1."
+    )
+
+    GROUND_MEMORY_ARENA_2_PTR = Symbol(
+        [0x324CB8], [0x2324CB8], 0x4, "Pointer to GROUND_MEMORY_ARENA_2."
+    )
+
+    GROUND_MEMORY_ARENA_1 = Symbol(
+        [0x324FC0],
+        [0x2324FC0],
+        0x1C,
+        "This is a top-level memory arena used for some things in ground mode.\n\nIt's"
+        " used for user_flags 8, 15, and 16.\n\nIncluding the allocator metadata, this"
+        " arena occupies 0x64000 bytes of space.\n\ntype: struct mem_arena",
+    )
+
+    GROUND_MEMORY_ARENA_1_BLOCKS = Symbol(
+        [0x324FDC],
+        [0x2324FDC],
+        0x4E0,
+        "The block array for GROUND_MEMORY_ARENA_1.\n\ntype: struct mem_block[52]",
+    )
+
+    GROUND_MEMORY_ARENA_1_MEMORY = Symbol(
+        [0x3254BC], [0x23254BC], 0x63B04, "The memory region for GROUND_MEMORY_ARENA_1."
+    )
 
     SENTRY_DUTY_STRUCT = Symbol([0x37A5D0], [0x237A5D0], 0x38D4, "")