audio_samples 2.0.0

A typed audio processing library for Rust that treats audio as a first-class, invariant-preserving object rather than an unstructured numeric buffer.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

#[cfg(not(all(feature = "plotting", feature = "transforms")))]
fn main() {
    eprintln!("error: This example requires the `plotting` and `transforms` features.");
    std::process::exit(1);
}

#[cfg(all(feature = "plotting", feature = "transforms"))]
fn main() -> audio_samples::AudioSampleResult<()> {
    use std::time::Duration;

    use audio_samples::operations::AudioPlotting;
    use audio_samples::operations::plotting::PlotUtils;
    use audio_samples::operations::plotting::spectrograms::SpectrogramPlotParams;
    use audio_samples::{sample_rate, sine_wave};
    println!("Testing configurable frequency range padding...\n");

    // Generate a 440 Hz tone
    let audio = sine_wave::<f32>(
        440.0,
        Duration::from_secs_f32(1.0),
        sample_rate!(44100),
        0.5,
    );

    // Test with different padding values
    let padding_options = vec![
        (0.0, "0% (tight fit)"),
        (0.1, "10% (default)"),
        (0.3, "30% (more context)"),
        (0.5, "50% (lots of context)"),
    ];

    for (padding, description) in padding_options {
        println!("Creating spectrogram with {} padding...", description);

        let mut params = SpectrogramPlotParams::mel_db();
        params.freq_range_padding = Some(padding);

        let plot = audio.plot_spectrogram(&params)?;
        let html = plot.html()?;
        assert!(
            !html.is_empty() && html.contains("plotly"),
            "spectrogram HTML for {:.0}% padding should be a non-empty Plotly document",
            padding * 100.0
        );
        println!("  Rendered ({} bytes)", html.len());
    }
    Ok(())
}