Struct OpticastSettings 

pub struct OpticastSettings {
    pub xres: u32,
    pub yres: u32,
    pub y_start: u32,
    pub y_end: u32,
    pub hx: f32,
    pub hy: f32,
    pub hz: f32,
    pub anginc: i32,
    pub mip_levels: u32,
    pub mip_scan_dist: i32,
    pub max_scan_dist: i32,
}

Per-frame settings the orchestrator forwards to the builders. Most fields map 1:1 onto a voxlap global (vx5.anginc, vx5.mipscandist, vx5.maxscandist) or a setcamera argument (dahx / dahy / dahz). mip_levels is voxlap’s gmipnum — 1 for the oracle scene.

y_start..y_end is the strip-render iteration bound (R12.3). Default is the full framebuffer (0..yres), giving pre-R12.3 full-frame opticast behaviour bit-exactly. Tile / strip callers set a sub-range to render only that horizontal strip — pass-1 gline ray casts and pass-2 hrend / vrend writes both stay inside the strip’s y-range. The camera projection center stays in absolute screen coords; only the viewport edges shrink.

Fields

xres: u32

yres: u32

y_start: u32

First y-row this opticast call renders (inclusive). 0 for full-frame.

y_end: u32

One past the last y-row (exclusive). yres for full-frame.

hx: f32

hy: f32

hz: f32

anginc: i32

mip_levels: u32

mip_scan_dist: i32

max_scan_dist: i32

Implementations

impl OpticastSettings

pub fn for_oracle_framebuffer(width: u32, height: u32) -> Self

Default settings for a width × height framebuffer with the voxlap-oracle convention (hx, hy, hz) = (w/2, h/2, w/2) and anginc = 1, matching tests/oracle/oracle.c. Renders the full frame (y_start = 0, y_end = height).

pub fn with_y_range(self, y_start: u32, y_end: u32) -> Self

Restrict this settings struct to the [y_start, y_end) horizontal strip. Used by the per-strip parallel dispatch (R12.3.1) — each strip clones the base settings and clamps the y-range. Caller is responsible for ensuring y_start < y_end <= yres.

Trait Implementations

impl Clone for OpticastSettings

fn clone(&self) -> OpticastSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OpticastSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for OpticastSettings