May be inlined for small lengths

BT.601 YUV (0-255) -> RGB (0-255).

All application routes (no nesting required).

Arm the watchdog: allow recompiled code `secs` of wall-clock time, then stop it.

Bind to localhost only for security.

Build a GCFS archive from extracted disc files. Format (all integers little-endian): ```text Header: magic b"GCFS" | version u32 | file_count u32 |

Dispatch a recompiled function by address. The placeholder knows none.

Clear all vertex attribute descriptors to `None`.

Submit an RGBA color for color channel 1.

Compile the game crate and produce a named executable.

Compute the total file size of a DOL from its header. DOL header: 7 text sections + 11 data sections, each with (file_offset, size).

Compute the number of f32 values per vertex (stride) based on the attribute layout of the **first** flushed vertex. This is safe because all vertices

Convert GX triangle fan to triangle list (fan with center V0: V0V1V2, V0V2V3, ...).

Convert GX quads to triangles (quad ABCD → triangles ABC + ACD).

Helper: build the default vertex descriptor array with all inputs as None.

Download and install Ghidra to ~/.local/share/gcrecomp/.

Download the dolphin-emu-tool Arch package and extract just the binary into the project's tools/ directory. No root access required.

Close a file handle. Returns true if the handle was valid.

Get the decompressed file length for an open handle.

Open a file by path. Returns a handle (>0) or 0 on failure. GameCube games use paths like `/banner.bnr` or `audio/stream.adp`. We normalize by stripp

Read data from an open file into GameCube memory. Decompresses the file on first access and caches the result. Copies `length` bytes starting at `off

Dead code elimination pass. Removes instructions that write to registers never subsequently read.

Emit the block terminator: set `__blk` to the next/target block, call+continue (bl), or return. `cur` is the current block index, `n` the block count.

Enable the call trace (logs the first few thousand function entries).

Export decompiled C code for functions

Export decompiled C code for functions

Export all function information

Export all function information

Export all symbol information

Export all symbol information

Extract all files from a GameCube disc image's FST. The FST location is stored at disc offset 0x424 (FST offset) and 0x428 (FST size). Each FST entry

Convert RVZ to ISO once, then extract both DOL and filesystem files. This avoids converting twice when the caller needs both.

Extract a DOL from a zip archive. Strategy: 1. Look for .dol files by extension. 2. Look for disc images (.iso, .gcm) by extension → extract DOL from

Finalize the current buffer: apply master volume, clamp, and return.

May be called frequently

Find dolphin-tool in PATH or local tools/ directory. If not found anywhere, download the Arch package and extract it locally.

Constant folding and propagation pass. Tracks constant values loaded by `li` (opcode 14 with rA=0) and `addi` patterns, propagating them through regi

Generate a function body as a basic-block state machine: `let mut __blk = 0; loop { match __blk { 0 => {...}, ... } }`. Branches set `__blk` to the ta

Appends the WGSL code for a single TEV stage to `out`.

Get the Ghidra download URL by querying the GitHub releases API. Falls back to a known-good version if the API call fails.

Get the lower 32 bits of the timebase counter (OSGetTick).

Convert a GX primitive type byte to wgpu PrimitiveTopology.

Initialize the virtual DVD filesystem from an embedded GCFS archive.

Initialize wgpu-dependent resources (bind group / pipeline layouts).

Initialize the shared bind group layout and pipeline layout.

Load the DOL memory image into RAM. The placeholder has no image.

Main export function

Main export function

OSAllocFromArenaHi - Allocate memory from high end of arena.

OSAllocFromArenaLo - Allocate memory from low end of arena.

OSDisableInterrupts - Disable all maskable interrupts, return previous state.

OSFatal - Fatal error handler.

OSGetArenaHi - Get current high arena pointer.

OSGetArenaLo - Get current low arena pointer.

OSGetConsoleType - Returns console hardware revision.

OSReport - Debug output function.

OSRestoreInterrupts - Restore interrupt enable state.

OSSetArenaHi - Set the high arena pointer directly.

OSSetArenaLo - Set the low arena pointer directly.

Submit a 3-component s16 position (converted to f32).

Present an RGBA8 framebuffer (read from emulated RAM) to the window by uploading it to a texture and blitting it fullscreen. `rgba.len()` must be `w *

Pull exactly `count` interleaved stereo samples for the audio output thread.

May be inlined for small lengths

Hot path - may be inlined