Struct BlipBuf 

pub struct BlipBuf { /* private fields */ }

Streaming BLEP decimator + filter chain that feeds host-rate samples to the frontend’s audio thread.

Implementations

impl BlipBuf

pub fn new(sample_rate: u32, cpu_rate: f64) -> Self

Create a new band-limited buffer.

sample_rate is the host audio rate in Hz (typically 44 100). cpu_rate is the NES CPU rate in Hz (CPU_HZ_NTSC or CPU_HZ_PAL).

pub fn set_filter_model(&mut self, model: FilterModel)

v2.1.3 — swap the analog output-filter model (see crate::mixer::FilterModel), rebuilding the filter chain at the current sample rate. This resets the filter’s IIR state, so switching while audio is playing (the Settings selector applies it live) produces a brief transient — as with any live filter swap. The frontend also applies it at ROM load / power-cycle, where there is no audible discontinuity.

pub fn reset(&mut self)

Reset to silence. Empties the input ring, the pending output queue, and the filter chain state.

pub fn add_sample(&mut self, value: f32)

Add one mixed sample at CPU resolution. The buffer accumulates host-rate samples internally; drain via Self::drain or Self::drain_all.

The mixer’s output is approximately in [-0.5, 0.5] for the 2A03 alone, with on-cart audio expansions pushing the absolute range up somewhat. We clamp value defensively so a stray NaN/Inf or runaway mapper can’t propagate non-finite values into the FIR state. The clamp range is far outside any sane mixer output, so the gate is purely a saturation backstop, not a normal-operation limiter.

pub fn drain(&mut self, out: &mut [f32]) -> usize

Drain finalized samples into out. Returns the number written. Excess pending samples are kept; if out.len() < self.samples.len() the remainder waits for the next drain.

pub fn drain_all(&mut self) -> Vec<f32>

Drain all finalized samples into a new Vec.

pub fn len(&self) -> usize

Number of samples currently buffered, awaiting drain.

pub fn is_empty(&self) -> bool

Whether the pending-output queue is empty.

Trait Implementations

impl Clone for BlipBuf

fn clone(&self) -> BlipBuf

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlipBuf

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

Formats the value using the given formatter.