audio_samples 1.0.5

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
50
51
52
53
54

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

#[cfg(all(feature = "dynamic-range", feature = "statistics"))]
pub fn main() -> audio_samples::AudioSampleResult<()> {
    use audio_samples::AudioStatistics;
    use audio_samples::operations::{
        AudioDynamicRange,
        types::{CompressorConfig, LimiterConfig},
    };
    use audio_samples::utils::generation::am_signal;
    use std::time::Duration;

    let sample_rate_hz = core::num::NonZeroU32::new(44_100).unwrap();

    // AM signal: varying envelope makes compression/limiting visible.
    let mut audio = am_signal::<f64>(
        440.0,
        2.0,
        0.9,
        Duration::from_secs(2),
        sample_rate_hz,
        0.95,
    );
    println!("Input: peak={:.4} rms={:.4}", audio.peak(), audio.rms());

    let config = CompressorConfig::vocal();
    let curve_input = [-40.0f64, -30.0, -20.0, -10.0, 0.0];
    let curve = audio.get_compression_curve(
        &config,
        non_empty_slice::NonEmptySlice::from_slice(&curve_input).unwrap(),
    )?;
    println!("Compressor curve (dB out): {:?}", curve);

    let gr = audio.get_gain_reduction(&config)?;
    let max_gr = gr.into_iter().fold(0.0f64, f64::max);
    println!("Max gain reduction: {:.2} dB", max_gr);

    audio.apply_compressor(&config)?;
    println!(
        "Compressed: peak={:.4} rms={:.4}",
        audio.peak(),
        audio.rms()
    );

    let limiter = LimiterConfig::mastering();
    audio.apply_limiter(&limiter)?;
    println!("Limited: peak={:.4} rms={:.4}", audio.peak(), audio.rms());

    Ok(())
}