0x44 — background_change_map
Calls CBackGround::ChangeMap(unsigned int,unsigned int), records a background/map command entry, and calls CBtlAcquisition::SortDroppedItem when the character sub-manager exists.
proven— handler traced, and exercised by at least one shipped script.
At a glance
| Opcode | 0x44 (68) |
|---|---|
| Handler | CRadiScript::Command_44 |
| Signature | CRadiScript::Command_44(int,SCR_DATA*,unsigned int,unsigned int) |
| Translation unit | r_script_run4.cpp |
| Address | — debug build; click for all 3 |
| Handler size | 0x140 (320 bytes) |
| Engine name | background_change_map |
| Family | Background, map, landscape and camera |
| Command size | 4 + extra_words * 4 bytes |
Handler behaviour
Calls CBackGround::ChangeMap(unsigned int,unsigned int), records a background/map command entry, and calls CBtlAcquisition::SortDroppedItem when the character sub-manager exists.
Encoding
The command header is one 32-bit word, as described in §3 Instruction encoding:
31 24 23 16 15 8 7 0
+----------------+----------------+----------------+----------------+
| flags | argument byte | extra words | 0x44 |
+----------------+----------------+----------------+----------------+Bits 8–15 give the number of 32-bit operand words that follow. Bits 16–23 are handed to the handler as a bitfield; on character commands bit 0 normally says whether a character selector word is present. Bit 31 is the keep-going bit.
Operand fields
3 documented fields. input fields are read from the command's operand words; derived fields are computed from other fields rather than stored separately.
| Field | Role | Meaning |
|---|---|---|
arg | derived | Raw handler argument byte from the command header. It is printed only when it differs from the value the named fields already imply, so seeing it means the command uses an unusual argument encoding. |
mode | input | Handler path selector taken from the argument byte. The meaning is specific to each command. |
yield | derived | Pause the script here for one game frame; the next command runs on the following update. Lines without it keep running immediately. |
Engine calls
Engine functions this handler was observed calling:
CBackGround::ChangeMap(unsigned int,unsigned int)CBtlAcquisition::SortDroppedItem()CCharaPutManager::RevivalCCharacterManager::GetCharacterSubManager(int)