Skip to content

0x60 — load_texture

Texture load helper. It splits one stream word into texture id/group fields and calls LoadTextureFile(int,int,int,unsigned short,bool).

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

At a glance

Opcode0x60 (96)
HandlerCRadiScript::Command_60
SignatureCRadiScript::Command_60(int,SCR_DATA*,unsigned int,unsigned int)
Translation unitr_script_run6.cpp
Address— debug build; click for all 3
Handler size0x54 (84 bytes)
FamilyPrimitives, textures, sound and movies
Command size4 + extra_words * 4 bytes

Handler behaviour

Texture load helper. It splits one stream word into texture id/group fields and calls LoadTextureFile(int,int,int,unsigned short,bool).

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

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

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

FieldRoleMeaning
groupinputWhich group the target belongs to.
modeinputHandler path selector taken from the argument byte. The meaning is specific to each command.
raw_byte3inputByte 3 of the packed raw entry.
textureinputTexture operand for this 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:

  • LoadTextureFile(int,int,int,unsigned short,bool)

Bit masks

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

0x001F 0xFFFF 0x00FF