Struct Waveform 

pub struct Waveform<'a> { /* private fields */ }

Builder that renders mono audio samples as a waveform image.

Samples are expected as amplitudes in [-1.0, 1.0], the usual DSP convention; other symmetric ranges work too since the y-axis scales to the data. For interleaved stereo data, split it with crate::deinterleave_stereo first and render each channel separately.

Example

use audio_visualizer::waveform::Waveform;

let samples: Vec<f32> = vec![0.0, 0.5, -0.5, 0.3];
Waveform::new(&samples)
    .sample_rate(44100.0)
    .write_png("waveform.png")
    .unwrap();

Implementations

impl<'a> Waveform<'a>

pub const fn new(samples: &'a [f32]) -> Self

Creates a waveform visualization of the given mono samples.

pub const fn sample_rate(self, sample_rate_hz: f32) -> Self

Labels the x-axis with seconds instead of sample indices.

pub const fn size(self, width: u32, height: u32) -> Self

Sets the image dimensions in pixels. Default: 1400x400.

pub fn title(self, title: impl Into<String>) -> Self

Sets a title displayed above the chart.

pub fn to_svg(&self) -> Result<String, Error>

Renders the waveform to an SVG string.

pub fn write_png(&self, path: impl AsRef<Path>) -> Result<(), Error>

Renders the waveform and writes it as PNG file, creating missing parent directories.

Trait Implementations

impl<'a> Clone for Waveform<'a>

fn clone(&self) -> Waveform<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Waveform<'a>

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

Formats the value using the given formatter.