Struct WavWriter 

pub struct WavWriter { /* private fields */ }

Streaming WAV writer that accepts mono 16 kHz f32 samples and emits 16-bit signed PCM.

Samples are clamped into [-1.0, 1.0] before the cast to i16. WavWriter::finalize must be called to flush the header; on drop without finalisation the file is left with an invalid header (size field unwritten) — the orchestrator therefore always calls finalize, even on signal-driven shutdown.

Implementations

impl WavWriter

pub fn create(path: impl AsRef<Path>) -> Result<Self>

Creates a WAV file at path, with parent directories created if they do not exist. The header is written eagerly; the size field is patched up by WavWriter::finalize.

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

Writes a chunk of mono samples. Values outside [-1.0, 1.0] are clamped (resampler overshoot near 0 dBFS).

pub fn samples_written(&self) -> u64

Number of samples written so far (not counting any clamped value any differently).

pub fn path(&self) -> &Path

Path the WAV was created at.

pub fn finalize(self) -> Result<()>

Flushes the WAV header so the file is playable. Consumes self so double-finalisation cannot occur. Always call this — including on signal-driven shutdown — or the on-disk file will be malformed.