Struct ScalarRasterizer 

pub struct ScalarRasterizer<'a> { /* private fields */ }

Scalar rasterizer that writes pixels and a z-buffer entry per screen position.

Borrows the framebuffer + zbuffer for the duration of one opticast call; SDL hosts allocate these once and reuse across frames, see roxlap-host.

Implementations

impl<'a> ScalarRasterizer<'a>

pub fn new( framebuffer: &'a mut [u32], zbuffer: &'a mut [f32], pitch_pixels: usize, slab_buf: &'a [u8], column_offsets: &'a [u32], mip_base_offsets: &'a [usize], vsid: u32, ) -> Self

Create a rasterizer that will write into the supplied framebuffer + zbuffer pair. pitch_pixels must satisfy pitch_pixels * height ≤ framebuffer.len() for the height the engine renders into; the frame_setup hook does not validate sizes (it has no height to check against).

slab_buf / column_offsets / mip_base_offsets / vsid describe the world the renderer reads from. Pass the matching fields from a roxlap_formats::vxl::Vxl (or, for tests, &[0, vsid² + 1] as the single-mip placeholder).

ray_step is initialised to a zero placeholder; the real values get stamped on the first Rasterizer::frame_setup call before any per-pixel work runs.

pub fn with_sky(self, sky: &'a Sky) -> Self

Bind a sky texture for the lifetime of this rasterizer instance. Hosts call this when crate::Engine::sky is Some(_). Without it, the rasterizer keeps the legacy solid-fill skycast behaviour.

Trait Implementations

impl<'a> Clone for ScalarRasterizer<'a>

fn clone(&self) -> ScalarRasterizer<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Rasterizer for ScalarRasterizer<'_>

fn frame_setup(&mut self, ctx: &ScanContext<'_>)

Called once per frame, before the four-quadrant scan loops run, with the per-frame derived state. Concrete rasterizers override this to cache whatever they need from the projection / ray-step / prelude triple (a default-noop stub is fine for recording / counting test rasterizers).

fn gline( &mut self, scratch: &mut ScanScratch, length: u32, x0: f32, y0: f32, x1: f32, y1: f32, )

fn hrend( &mut self, scratch: &mut ScanScratch, sx: i32, sy: i32, p1: i32, plc: i32, incr: i32, j: i32, )

fn vrend( &mut self, scratch: &mut ScanScratch, sx: i32, sy: i32, p1: i32, iplc: i32, iinc: i32, )