SplitScript reference / GCNEmulator / read

GCNEmulator.read

Method

GCNEmulator.read<T>(address: u32) -> T! where T: MemoryReadable

Reads a typed value from emulated GameCube MEM1.

Valid reads lie entirely within 0x80000000..=0x817fffff. Primitive values, record fields, and fixed-array elements are decoded using the GameCube's big-endian byte order.

Parameters

  • address: The original GameCube memory address.

Effects: reads process memory, requires an attached process

Runtime behavior: available while a process is attached, except in onDetach; synchronous

Examples

Read an emulated value

let health: u16 = gcn.read(0x80001234) else 0