Struct PixelProvenanceFrame 

pub struct PixelProvenanceFrame { /* private fields */ }

One frame of PixelProvenance, indexed by y * SCREEN_W + x.

Overwritten in place every frame, exactly like the framebuffer it shadows, so a query after run_frame describes the frame the user is looking at.

Implementations

impl PixelProvenanceFrame

pub const HEAP_BYTES: usize

Heap cost of one armed frame, in bytes.

pub fn new() -> Self

Allocate a cleared frame.

pub fn get(&self, x: usize, y: usize) -> Option<PixelProvenance>

The record for screen pixel (x, y), or None if either coordinate is off-screen. Returning None rather than clamping matters: a clamped query would answer confidently about a pixel the caller did not ask for.

pub fn set(&mut self, x: usize, y: usize, rec: PixelProvenance)

Record a pixel. Out-of-range coordinates are dropped rather than wrapping into an unrelated pixel.

pub fn pixels(&self) -> &[PixelProvenance]

The whole frame, row-major.

pub fn clear(&mut self)

Forget every recorded pixel, keeping the allocation.

Called on power-cycle and on save-state restore for the same reason WriteAttribution::clear is: the records describe a timeline the restore replaced. The framebuffer analogy does NOT excuse keeping them — the framebuffer is serialized and comes back consistent with the restored state, whereas this frame is not, so a restore landing mid-frame would leave pre-restore addresses for every pixel above the current scanline with nothing marking them stale.

Trait Implementations

impl Clone for PixelProvenanceFrame

fn clone(&self) -> PixelProvenanceFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PixelProvenanceFrame

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

Formats the value using the given formatter.

impl Default for PixelProvenanceFrame

fn default() -> Self

Returns the “default value” for a type.