pmdsky-debug-py 10.0.5__py3-none-any.whl → 10.0.8__py3-none-any.whl

pmdsky_debug_py/_release.py

@@ -1 +1 @@
-RELEASE = "v0.10.0+5744c5ec24"
+RELEASE = "v0.10.0+b64a9fa281"

pmdsky_debug_py/eu.py

@@ -2906,7 +2906,7 @@ class EuArm9Functions:
         [0x1E14C],
         [0x201E14C],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13565,11 +13565,18 @@ class EuOverlay11Functions:
 
     SsbLoad2 = Symbol([0x84BC], [0x22E503C], None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         [0x866C],
         [0x22E51EC],
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        [0x86A0],
+        [0x22E5220],
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol([0x8994], [0x22E5514], None, "")
@@ -17336,7 +17343,7 @@ class EuOverlay29Functions:
         [0x2235C],
         [0x22FEEDC],
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20821,11 +20828,25 @@ class EuOverlay29Functions:
         "Calls HandleFadesDungeon for both screens.\n\nNo params.",
     )
 
+    DisplayFloorTip = Symbol(
+        [0x70C08],
+        [0x234D788],
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        [0x70D34],
+        [0x234D8B4],
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         [0x70F70],
         [0x234DAF0],
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -22449,6 +22470,13 @@ class EuRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        [0x2A3F1C],
+        [0x22A3F1C],
+        0x104,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         [0x2A4164],
         [0x22A4164],

pmdsky_debug_py/eu_itcm.py

@@ -2819,7 +2819,7 @@ class EuItcmArm9Functions:
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13217,11 +13217,18 @@ class EuItcmOverlay11Functions:
 
     SsbLoad2 = Symbol(None, None, None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         None,
         None,
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        None,
+        None,
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol(None, None, None, "")
@@ -16784,7 +16791,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20251,11 +20258,25 @@ class EuItcmOverlay29Functions:
         None, None, None, "Calls HandleFadesDungeon for both screens.\n\nNo params."
     )
 
+    DisplayFloorTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         None,
         None,
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -21753,6 +21774,13 @@ class EuItcmRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        None,
+        None,
+        None,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         None,
         None,

pmdsky_debug_py/jp.py

@@ -2904,7 +2904,7 @@ class JpArm9Functions:
         [0x1E108],
         [0x201E108],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13536,11 +13536,18 @@ class JpOverlay11Functions:
 
     SsbLoad2 = Symbol([0x8448], [0x22E5D28], None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         [0x85F8],
         [0x22E5ED8],
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        None,
+        None,
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol([0x8920], [0x22E6200], None, "")
@@ -17118,7 +17125,7 @@ class JpOverlay29Functions:
         [0x21FC4],
         [0x22FF8A4],
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20600,11 +20607,25 @@ class JpOverlay29Functions:
         "Calls HandleFadesDungeon for both screens.\n\nNo params.",
     )
 
+    DisplayFloorTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         [0x70874],
         [0x234E154],
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -22121,6 +22142,13 @@ class JpRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        None,
+        None,
+        None,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         None,
         None,

pmdsky_debug_py/jp_itcm.py

@@ -2819,7 +2819,7 @@ class JpItcmArm9Functions:
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13217,11 +13217,18 @@ class JpItcmOverlay11Functions:
 
     SsbLoad2 = Symbol(None, None, None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         None,
         None,
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        None,
+        None,
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol(None, None, None, "")
@@ -16784,7 +16791,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20251,11 +20258,25 @@ class JpItcmOverlay29Functions:
         None, None, None, "Calls HandleFadesDungeon for both screens.\n\nNo params."
     )
 
+    DisplayFloorTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         None,
         None,
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -21753,6 +21774,13 @@ class JpItcmRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        None,
+        None,
+        None,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         None,
         None,

pmdsky_debug_py/na.py

@@ -2906,7 +2906,7 @@ class NaArm9Functions:
         [0x1E0B0],
         [0x201E0B0],
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13572,11 +13572,18 @@ class NaOverlay11Functions:
 
     SsbLoad2 = Symbol([0x84BC], [0x22E46FC], None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         [0x866C],
         [0x22E48AC],
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        [0x86A0],
+        [0x22E48E0],
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol([0x8994], [0x22E4BD4], None, "")
@@ -17359,7 +17366,7 @@ class NaOverlay29Functions:
         [0x2227C],
         [0x22FE4BC],
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20844,11 +20851,25 @@ class NaOverlay29Functions:
         "Calls HandleFadesDungeon for both screens.\n\nNo params.",
     )
 
+    DisplayFloorTip = Symbol(
+        [0x70948],
+        [0x234CB88],
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        [0x70A74],
+        [0x234CCB4],
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         [0x70CB0],
         [0x234CEF0],
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -22475,6 +22496,13 @@ class NaRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        [0x2A35DC],
+        [0x22A35DC],
+        0x104,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         [0x2A3824],
         [0x22A3824],

pmdsky_debug_py/na_itcm.py

@@ -2819,7 +2819,7 @@ class NaItcmArm9Functions:
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: header_ptr\nr1: unk_pal\nr2: unk_tex\nr3: unk_tex_param",
+        "Prepare a WTE data to be loaded into VRAM. Seems to need to be called with another undocumented function (at 0x0201e1d8 (EU))\nIt skips the texture and/or the palette if missing from the file. The texture VRAM has 128KiB of space, and palette has 16KiB.\nThe true palette VRAM offset will be upper_part*0x100+lower_part\n\nThis may or may not be the function that adds to the queue so it can be added during VBlank.\n\nr0: pointer to the WTE file header loaded in memory\nr1: where the WTE texture will be loaded in the VRAM (from 0 to 0x1FFFF)\nr2: upper part of the palette VRAM\nr3: lower part of the palette VRAM",
     )
 
     GeomSetTexImageParam = Symbol(
@@ -13217,11 +13217,18 @@ class NaItcmOverlay11Functions:
 
     SsbLoad2 = Symbol(None, None, None, "")
 
-    ProcessScriptParam = Symbol(
+    ScriptParamToInt = Symbol(
         None,
         None,
         None,
-        "Checks if the two most significant bits (0x8000 and 0x4000) are set on a given script opcode parameter, and modifies the value if so.\n\nr0: On input, the parameter. On output, the modified parameter if either of the two bits listed above is set, same parameter otherwise.",
+        "Converts the given opcode parameter to a signed integer.\n\nThe parameter will be returned unchanged unless one of its two most significant bits (0x8000 and 0x4000) are set, in which case both bits will be cleared and the original value will be modified according to the following two rules:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the value will be set to value / 256, rounded down.\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a signed integer",
+    )
+
+    ScriptParamToFixedPoint16 = Symbol(
+        None,
+        None,
+        None,
+        "Converts the given opcode parameter to a 16-bit signed fixed-point number with 8 fraction bits.\n\nThe resulting number is encoded as (value) * 256, with the last byte acting as a fraction byte capable of representing multiples of 1/256.\n\nThe parameter will either be returned unchanged or modified depending on which of its two most significant bits (0x8000 and 0x4000) are set. Both bits are unset before running the operations listed below:\n- If the 0x4000 bit is set (sign bit), the value will be set to -16384 + value.\n- If the 0x8000 bit is set (fixed-point flag), the raw value is interpreted as being fixed-point already, and nothing else happens. Otherwise, it's assumed to be a normal integer and is converted to fixed-point by left-shifting it by 8 (moving the integer part to its proper place).\nBoth rules can be applied, in the same order as listed, if both conditions are met.\n\nr0: Parameter to convert\nreturn: The input parameter, as a 16-bit signed fixed-point number with 8 fraction bits",
     )
 
     StationLoadHanger = Symbol(None, None, None, "")
@@ -16784,7 +16791,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         None,
-        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity",
+        "Executes the set action for the specified monster. Used for both AI actions and player-inputted actions. If the action is not ACTION_NOTHING, ACTION_PASS_TURN, ACTION_WALK or ACTION_UNK_4, the monster's already_acted field is set to true. Includes a switch based on the action ID that performs the action, although some of them aren't handled by said swtich.\n\nr0: Pointer to monster entity\nreturn: If the result is true, the AI is run again for the current ally, and it performs another action. This can happen up to three times.",
     )
 
     TryActivateFlashFireOnAllMonsters = Symbol(
@@ -20251,11 +20258,25 @@ class NaItcmOverlay29Functions:
         None, None, None, "Calls HandleFadesDungeon for both screens.\n\nNo params."
     )
 
+    DisplayFloorTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip that displays on floor change, based on which tips have already been displayed.\n\nNo params.\n\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
+    DisplayItemTip = Symbol(
+        None,
+        None,
+        None,
+        "Display the dungeon tip if not already displayed matching the (presumably newly acquired) item\n\nr0: item id\nreturn: 1 if a tip has been displayed, 0 otherwise",
+    )
+
     DisplayDungeonTip = Symbol(
         None,
         None,
         None,
-        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log",
+        "Checks if a given dungeon tip should be displayed at the start of a floor and if so, displays it. Called up to 4 times at the start of each new floor, with a different r0 parameter each time.\n\nr0: Pointer to the message_tip struct of the message that should be displayed\nr1: True to log the message in the message log\n\nreturn: 1 if the message has been displayed, 0 if it wasn’t",
     )
 
     SetBothScreensWindowColorToDefault = Symbol(
@@ -21753,6 +21774,13 @@ class NaItcmRamData:
         "Starts at 0 when the game is first launched, and continuously ticks up once per frame while the game is running.",
     )
 
+    TOUCHSCREEN_STATUS = Symbol(
+        None,
+        None,
+        None,
+        "Status of the touchscreen, including the coordinates of the currently pressed position in pixels.",
+    )
+
     BAG_ITEMS = Symbol(
         None,
         None,

pmdsky_debug_py/protocol.py

@@ -11299,7 +11299,12 @@ class Overlay11FunctionsProtocol(Protocol):
         None,
     ]
 
-    ProcessScriptParam: Symbol[
+    ScriptParamToInt: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
+    ScriptParamToFixedPoint16: Symbol[
         Optional[list[int]],
         None,
     ]
@@ -17142,6 +17147,16 @@ class Overlay29FunctionsProtocol(Protocol):
         None,
     ]
 
+    DisplayFloorTip: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
+    DisplayItemTip: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     DisplayDungeonTip: Symbol[
         Optional[list[int]],
         None,
@@ -18465,6 +18480,11 @@ class RamDataProtocol(Protocol):
         Optional[int],
     ]
 
+    TOUCHSCREEN_STATUS: Symbol[
+        Optional[list[int]],
+        Optional[int],
+    ]
+
     BAG_ITEMS: Symbol[
         Optional[list[int]],
         Optional[int],

{pmdsky_debug_py-10.0.5.dist-info → pmdsky_debug_py-10.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pmdsky-debug-py
-Version: 10.0.5
+Version: 10.0.8
 Summary: pmdsky-debug symbols for Python.
 Author-email: Marco 'Capypara' Köpcke <hello@capypara.de>
 License: MIT

pmdsky_debug_py-10.0.8.dist-info/RECORD

@@ -0,0 +1,14 @@
+pmdsky_debug_py/__init__.py,sha256=xvXjdxEqeoQaaS6ssZYVI9jARzv5M4q6FNwA3Z6fOw4,1831
+pmdsky_debug_py/_release.py,sha256=eBJlo1bkuLv2B7ifSsgs5jKccgy9uKqn24HR49j5uro,31
+pmdsky_debug_py/eu.py,sha256=_2ERRptVVIM54re1CBTbQW7iAunsKCMfYp3o8MueYjU,903808
+pmdsky_debug_py/eu_itcm.py,sha256=W_g5V0SHJivPSCerRgRxXxXrojJ6K991GDoZ2n9QN98,854008
+pmdsky_debug_py/jp.py,sha256=ontZuxBqpm1zZBFZsrsWA4zjyddXwmUpzOYVmdKg8Uo,888602
+pmdsky_debug_py/jp_itcm.py,sha256=xW4xkQZoft7gBS9KRAYfbX3v4A8w5cN2TBHWCwqkBnU,853998
+pmdsky_debug_py/na.py,sha256=IvdMXCD74Pr1nnfpzLFipQOZkRjho1oncpYW4nW3umM,905020
+pmdsky_debug_py/na_itcm.py,sha256=I8zP_YvmTtdbARbQKegk29xL1MlJZpjexEHMXaqRcDI,854028
+pmdsky_debug_py/protocol.py,sha256=JrjZgrepsucNPZBdMSEscAyXzExrIlwvTUAsdhOi4cg,324587
+pmdsky_debug_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pmdsky_debug_py-10.0.8.dist-info/METADATA,sha256=ONiezLq-JnaZDKvC4BqXj9bcacWQbVm7xFvXcer5P_k,1373
+pmdsky_debug_py-10.0.8.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+pmdsky_debug_py-10.0.8.dist-info/top_level.txt,sha256=cqvpcJbud2s8IyBAc1MfCySwniko_6qO5LWSSxNIoXI,16
+pmdsky_debug_py-10.0.8.dist-info/RECORD,,

pmdsky_debug_py-10.0.5.dist-info/RECORD

@@ -1,14 +0,0 @@
-pmdsky_debug_py/__init__.py,sha256=xvXjdxEqeoQaaS6ssZYVI9jARzv5M4q6FNwA3Z6fOw4,1831
-pmdsky_debug_py/_release.py,sha256=d3PVWchf-rC3TKpWCO7UPX06yxzTwdgvEZ0lyUUlQ84,31
-pmdsky_debug_py/eu.py,sha256=j0i0Ui2a2BAc6zhWECaIBMQ88SvGnGk6PhF1tQmkSDQ,900867
-pmdsky_debug_py/eu_itcm.py,sha256=baAm0kpNbW7lHzc6WWQqo4TdxvReey-SDbYZltnq3ho,851116
-pmdsky_debug_py/jp.py,sha256=UeEujecn0I2Hfsy6X25KTICUn7f9nSvhpBbhjHOLljk,885710
-pmdsky_debug_py/jp_itcm.py,sha256=J9-MZlfEC5NLamR5oaNLDAuBELkv67B7dU_THWt4VsY,851106
-pmdsky_debug_py/na.py,sha256=r7yjXh07pr5RdxsN3rr4xhnfPEW-oC3NX6VQOamltHE,902079
-pmdsky_debug_py/na_itcm.py,sha256=VnxXnTIeeCbNhGQaV_SNzwp_7JhG3d6LOsutUvxlXrc,851136
-pmdsky_debug_py/protocol.py,sha256=2L0AGCpSIjCHz6PnImla8OG04PZpIDBywiSg076RJLs,324252
-pmdsky_debug_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pmdsky_debug_py-10.0.5.dist-info/METADATA,sha256=0UMRPfyzSkh883MEXC3vfapEwsjQpzg2yUFTDy2lgG4,1373
-pmdsky_debug_py-10.0.5.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-pmdsky_debug_py-10.0.5.dist-info/top_level.txt,sha256=cqvpcJbud2s8IyBAc1MfCySwniko_6qO5LWSSxNIoXI,16
-pmdsky_debug_py-10.0.5.dist-info/RECORD,,