Skip to content
Radiata Stories

0x58 — position_vibration_clear

Position vibration/vector cleanup helper. It deletes CSingleManager elements and calls CHierarchicalObject::MakePivotMatrix in two cleanup branches.

proven— handler traced, and exercised by at least one shipped script.

At a glance

Opcode0x58 (88)
HandlerCRadiScript::Command_58
SignatureCRadiScript::Command_58(int,SCR_DATA*,unsigned int,unsigned int)
Translation unitr_script_run5.cpp
Address— debug build; click for all 3
Handler size0xC0 (192 bytes)
Engine nameposition_vibration_clear
FamilyBackground, map, landscape and camera
Command size4 + extra_words * 4 bytes

Handler behaviour

Position vibration/vector cleanup helper. It deletes CSingleManager elements and calls CHierarchicalObject::MakePivotMatrix in two cleanup branches.

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   |  0x58          |
+----------------+----------------+----------------+----------------+

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

2 documented fields. input fields are read from the command's operand words; derived fields are computed from other fields rather than stored separately.

FieldRoleMeaning
modeinputHandler path selector taken from the argument byte. The meaning is specific to each command.
yieldderivedPause 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:

  • CHierarchicalObject::MakePivotMatrix()
  • CSingleManager::DeleteAllElements()

Bit masks

Masks the handler applies to its argument byte or operand words:

0x0001 0x0002