Struct PcmBuffer 

pub struct PcmBuffer { /* private fields */ }

Rolling / accumulating mono PCM buffer at WHISPER_SAMPLE_RATE.

Storage is a fixed-capacity ring. Capacity is never exceeded, including when a single push is larger than capacity (only the newest tail is retained).

Implementations

impl PcmBuffer

pub fn with_max_secs(max_secs: f64) -> Self

Create a buffer capped at max_secs of audio (rolling by default).

pub fn dictation() -> Self

Dictation-oriented default: ~60 s rolling window.

pub fn bounded(max_secs: f64) -> Self

Grow until max_secs, then error instead of dropping audio.

pub fn clear(&mut self)

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn max_samples(&self) -> usize

pub fn is_rolling(&self) -> bool

pub fn duration_secs(&self) -> f64

pub fn clamped_count(&self) -> u64

How many samples were amplitude-clamped into [-1, 1] since construction.

pub fn samples(&self) -> ContiguousSamples<'_>

Contiguous view of logical samples.

When the ring is not wrapped this is zero-copy. When wrapped, samples are linearized into a temporary Vec (only on this call).

pub fn copy_samples_into(&self, dst: &mut Vec<f32>)

Copy logical samples into dst (reused by hosts to avoid allocation).

pub fn push(&mut self, chunk: &[f32]) -> Result<()>

Append mono f32 samples already at 16 kHz.

Rejects NaN/Inf. Samples outside [-1, 1] are clamped and counted. Oversized chunks in rolling mode keep only the newest max_samples without ever allocating beyond capacity.

pub fn rms(&self) -> f32

RMS energy using f64 accumulation (numerically stable for long windows).

pub fn to_audio_input(&self) -> Result<AudioInput>

Snapshot as AudioInput without clearing the buffer.

pub fn take_audio_input(&mut self) -> Result<AudioInput>

Take ownership of samples and clear the buffer.

Trait Implementations

impl Clone for PcmBuffer

fn clone(&self) -> PcmBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PcmBuffer

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

Formats the value using the given formatter.