Struct MixTrace 

pub struct MixTrace { /* private fields */ }

One frame’s worth of per-CPU-cycle mix records.

The index is the cycle offset from Self::first_cycle, so no per-record timestamp is stored — that is what keeps the record at 16 bytes.

Two different numbers follow from that, and the first draft of this comment conflated them. An NTSC frame of 29,781 records is ~465 KiB; the allocation is MIX_CAP records reserved up front, which is 576 KiB, because the cap is sized from Dendy (the longest frame) rather than from NTSC. The buffer is therefore always the worst case, never the typical one.

Implementations

impl MixTrace

pub fn new() -> Self

An empty trace with capacity for the worst-case region.

pub fn clear(&mut self, first_cycle: u64)

Drop every record and re-anchor the trace at first_cycle.

pub fn push(&mut self, rec: MixRecord)

Append one mixed cycle. Beyond MIX_CAP the record is dropped and the trace is flagged Self::truncated.

pub const fn first_cycle(&self) -> u64

CPU cycle the first record corresponds to.

pub const fn truncated(&self) -> bool

Whether records were dropped for exceeding MIX_CAP.

pub fn records(&self) -> &[MixRecord]

Every record, oldest first.

pub fn at_cycle(&self, cycle: u64) -> Option<MixRecord>

The record for absolute CPU cycle, or None if it is outside the trace.

Trait Implementations

impl Clone for MixTrace

fn clone(&self) -> MixTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MixTrace

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

Formats the value using the given formatter.

impl Default for MixTrace

fn default() -> Self

Returns the “default value” for a type.