Struct RasterTarget 

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

Borrowed view of the framebuffer + zbuffer as raw pointers.

R12.2.0 introduces this so the per-frame ScalarRasterizer can be Copy (for the per-thread fan-out R12.2.1 lands). Holding &'a mut [u32] / &'a mut [f32] directly forces exclusive borrows per instance, blocking the four quadrants from running on four threads even though their pixel writes are disjoint.

Constructed safely from exclusive slice borrows — the slices are consumed and re-exposed as raw pointers tied to lifetime 'a via PhantomData. Once a RasterTarget exists, it is the sole path to the underlying memory; the slices cannot be used through any other channel for the duration of 'a.

Copy lets opticast hand each quadrant thread its own copy of the same target. The four threads write disjoint pixels (top / bottom / left / right wedges of the screen, no overlap), so pointer aliasing is safe under the documented invariant.

Safety contract for parallel use

Callers that copy a RasterTarget and pass copies to multiple threads MUST guarantee that the threads collectively write to pairwise-disjoint pixel indices. opticast enforces this via the four-quadrant wedge geometry (see scan_loops::{top,right, bottom,left}_quadrant). Single-threaded callers (R12.1 default) hold one copy and trivially satisfy the invariant.

Implementations

impl<'a> RasterTarget<'a>

pub fn new(framebuffer: &'a mut [u32], zbuffer: &'a mut [f32]) -> Self

Build a target from exclusive slice borrows. The slices are consumed (their &'a mut reborrow is the load-bearing thing — this constructor is the only way to mint a RasterTarget from safe code).

pub fn fb_len(self) -> usize

Framebuffer length in u32 elements.

pub fn fb_ptr(self) -> *mut u32

Raw mutable framebuffer pointer. Used by SSE blocks that do their own arithmetic + bounds reasoning.

Safety

Callers must respect fb_len and the parallel-use invariant.

pub fn zb_ptr(self) -> *mut f32

Raw mutable zbuffer pointer. Same contract as Self::fb_ptr.

pub unsafe fn write_color(self, idx: usize, color: u32)

Write one ARGB pixel.

Safety

idx < self.fb_len(), plus the parallel-use invariant.

pub unsafe fn write_depth(self, idx: usize, z: f32)

Write one z-buffer entry.

Safety

idx < self.fb_len() (zbuffer length matches fb), plus the parallel-use invariant.

Trait Implementations

impl<'a> Clone for RasterTarget<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RasterTarget<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for RasterTarget<'a>

impl Send for RasterTarget<'_>

impl Sync for RasterTarget<'_>