The file name as a `&str` (names are ASCII by construction).

32-bit read dispatch. `Some(value)` for every offset in the window; unrecognised offsets read as zero to match the general MMIO echo-buffer fallback.

Push the *pre-mutation* `snapshot` onto the history timeline and clear future entries -- any new edit forks history.

Entry point. Dispatches on `cli.command`; returns `Ok(())` on success, `Err` with a user-visible message on failure. `main()` prints the error and exi

Pump the SPU forward by `n` samples. Called by the frontend once per displayed frame (or when the audio callback drains the output ring), producing st

Save this project to a RON file, creating parent directories.

Resolve the per-split triangulation. Default split (0) and every unrecognised id fall back to the NW-SE diagonal so a future split id never silently e

Packed tpage word for textured polygon UV words. The material owns the tpage blend and dither bits; all other tpage address/depth bits are preserved

Snapshot of the 3D camera the frontend needs to drive the editor's HwRenderer this frame.

Convert a BCD byte pair to binary (used for MSF fields in commands). Returns 0xFF if either nibble is out of range.

End-to-end convert: bytes of a PNG/JPG/BMP → bytes of a PSXT blob. The returned `Vec<u8>` is ready to write to disk and `include_bytes!` into a game.

Decode the next 16-byte ADPCM block at `current_addr` into the voice's sample buffer, update `s_1`/`s_2` filter history, handle loop flags, and advanc

FNV-1a-64 over the visible display area's 15bpp pixel bytes, for Redux-parity comparisons. Rows are packed tightly (no stride padding) so a given (wid

Validate, cook, and encode one editor-authored grid as `.psxw` bytes.

Decode and execute a single instruction. Does not advance PC (the caller is responsible, to keep branch-delay handling localised to the branch opcodes

Clear the scratch rect, draw a primitive into it, return the VRAM hash.

Raw slot index.

Effective stack pointer -- `base + offset`, or `None` when both fields are zero (caller should keep the CPU's reset SP).

`true` when any pad is currently tracked. Used by the HUD + startup banner to show a "pad connected" indicator.

Build the 16-bit tpage word the GPU expects in UV1 high half.

Current operating mode. Diagnostic; games don't read this directly (they infer it from the ID byte in the poll).

Plan manual portal rooms from one contiguous authored world grid.

Plot a single 15bpp pixel at `(x, y)`. When `mode == Opaque` this is a plain VRAM write; otherwise we fetch the existing pixel and run the semi-transp

Read the 2048-byte user-data payload of a sector.

Get a mutable resource.

Convert to the u16 that [`psx_gte::math::Mat3I16::rotate_y`] (and `rotate_x` / `rotate_z`) consume. Drops the low 8 bits of the Q0.16 value to land on

Clamp a 32-bit sample to signed 16-bit range.

Flat sector index.

Set the drawing-area rectangle. Pixels outside this rect are clipped by the rasteriser.

Set the drawing offset -- added to every vertex by the GPU. Use this to position a coordinate system at the top-left of your back-buffer.

Sign-extend an 11-bit integer (PS1 vertex coords + drawing offset are 11-bit signed).

Format a `u16` as a fixed-width `0xABCD` hex label.

8-bit write dispatch. Only `DATA` accepts a byte write; every other register is 16-bit on the real chip.

Insert a known SDK GPU packet at a raw OT slot.

Blend a foreground pixel over a background pixel per `mode`. Both pixels are 15-bit BGR with a mask bit at bit 15. The mask bit of the result comes fr

Serialise the image. Output length is always a multiple of [`SECTOR_SIZE`].

Serialise as a raw .bin image -- 2352-byte Mode-2 Form-1 sectors with sync pattern, BCD MSF header, subheader, and valid Mode-2/Form-1 EDC/ECC. Use t

Bit-exact monochrome triangle dispatch. The host runs the CPU rasterizer's silicon-matched DDA (`scanline::build_setup`) and the shader tests each pix

Bit-exact textured-triangle dispatch: silicon-matched DDA coverage + determinant-plane UV interpolation. Results match the CPU rasterizer byte-for-byt

Pop the most recent snapshot back into `project`.

Convert editor-viewport coordinates (sector-units, room-centre-relative) to world-cell units. The viewport's `(0, 0)` is the room centre; world-cell `

Turn on HLE BIOS interception. Call after side-loading an EXE that expects BIOS services to be live without running the real BIOS boot sequence. Never

Enter failed phase.

Floor split-triangle heights in that triangle's corner order.

Aim the free camera at `target` from `distance` world units away along a fixed oblique down-and-aside direction. Larger `distance` = more zoomed out.

Corner members for one authored horizontal split triangle.

Reset the SPU to a sane playable state. Sets: - SPUCNT: enable, unmute, default reverb off, CD audio off - Main volume: max - Every voice: silenced (

Current internal-resolution multiplier in effect.

Copy a PSX-EXE payload into RAM at its declared load address. The caller is expected to also seed the CPU (see [`crate::Cpu::seed_from_exe`]) so exec

Filesystem-safe stem derived from a project display name. The editor keeps `ProjectDocument::name` as the user-facing source of truth, then uses this

Compose a [`TriFlat`] from three projected vertices, store it in the next slot of the static `tris` array, and link it into the OT keyed on average sc

Rasterize a Gouraud-shaded line -- interpolates RGB between `c0` and `c1` linearly in screen space. Uses the same Bresenham walk as the mono path; the

Seed CPU state from a PSX-EXE header so the next `step()` enters the homebrew at its entry point. Used for `PSOXIDE_EXE` side-loading that bypasses th

Set the projection-plane distance H (control 26). Larger H = longer focal length = narrower FOV.

Set OFX and OFY (control 24, 25) -- the screen-space offsets applied post-divide. Values are 15.16 fixed point; `160 << 16` = 160.0 px.

Advance the ADSR envelope by one sample. Returns the current envelope level after the step (0..=0x7FFF, Q15).

GP0(E2) texture-window word for this material.

Advance the controller by one display tick and build a render camera.