Struct WriteAttribution 

pub struct WriteAttribution { /* private fields */ }

Per-byte write attribution for the PPU’s own memories.

Construct via WriteAttribution::new. Every index is masked, so no accessor can panic on an out-of-range offset — a provenance query is a debugging convenience and must never be able to take down the emulator it is inspecting.

Implementations

impl WriteAttribution

pub const HEAP_BYTES: usize

Heap cost of one armed store, in bytes. Reported by the UI so the memory price of arming is visible rather than folded into general process growth.

pub fn new() -> Self

Allocate a cleared attribution store.

pub fn clear(&mut self)

Forget every recorded write, keeping the allocation.

Called on power-cycle and on save-state restore: attribution describes the history of this run, and a restored state’s bytes were not written by any instruction this session executed. Reporting stale PCs after a restore would be worse than reporting nothing.

pub fn record_ciram(&mut self, off: usize, pc: u16, cycle: u64, value: u8)

Record a write to internal nametable RAM at physical offset off (mirroring already resolved by the caller).

pub fn record_oam(&mut self, idx: u8, pc: u16, cycle: u64, value: u8)

Record a write to OAM at byte index idx.

pub const fn record_palette( &mut self, idx: usize, pc: u16, cycle: u64, value: u8, )

Record a write to palette RAM at post-mirroring index idx.

pub fn ciram(&self, off: usize) -> Option<WriteAttrib>

The write that last stored the CIRAM byte at physical offset off, or None if nothing has written it since the store was armed or cleared.

pub fn oam(&self, idx: u8) -> Option<WriteAttrib>

The write that last stored OAM byte idx.

pub const fn palette(&self, idx: usize) -> Option<WriteAttrib>

The write that last stored palette entry idx (post-mirroring).

Trait Implementations

impl Clone for WriteAttribution

fn clone(&self) -> WriteAttribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WriteAttribution

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

Formats the value using the given formatter.

impl Default for WriteAttribution

fn default() -> Self

Returns the “default value” for a type.