garjan 1.1.0

garjan — Environmental and nature sound synthesis: thunder, rain, wind, fire, impacts, ambience
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

//! Error handling: demonstrates how garjan reports errors
//! and how to handle them in application code.

use garjan::prelude::*;

fn main() {
    let sr = 44100.0;

    // Invalid sample rate
    match Thunder::new(500.0, 0.0) {
        Ok(_) => unreachable!(),
        Err(e) => println!("Expected error: {e}"),
    }

    // Invalid duration
    let mut wind = Wind::new(10.0, 0.5, sr).unwrap();
    match wind.synthesize(-1.0) {
        Ok(_) => unreachable!(),
        Err(e) => println!("Expected error: {e}"),
    }

    // Pattern: propagate with ?
    if let Err(e) = run_synthesis(sr) {
        eprintln!("Synthesis failed: {e}");
    }

    // Pattern: match on error variant
    match Rain::new(RainIntensity::Heavy, f32::NAN) {
        Err(GarjanError::InvalidParameter(msg)) => {
            println!("Parameter error: {msg}");
        }
        Err(GarjanError::SynthesisFailed(msg)) => {
            println!("Synthesis error: {msg}");
        }
        Err(e) => println!("Other error: {e}"),
        Ok(_) => unreachable!(),
    }
}

fn run_synthesis(sr: f32) -> garjan::error::Result<()> {
    let mut fire = Fire::new(0.7, sr)?;
    let _samples = fire.synthesize(1.0)?;
    println!("Fire synthesis OK");
    Ok(())
}