knyst 0.5.1

Real time dynamic audio graph and synthesis library
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
55
56
57
58
59

use anyhow::Result;
use knyst::controller::schedule_bundle;
use knyst::graph;
#[allow(unused)]
use knyst::{
    audio_backend::{CpalBackend, CpalBackendOptions, JackBackend},
    controller::print_error_handler,
    prelude::*,
};

/// Configures a wavetable oscillator to output audio after a number of seconds.
///
/// The function performs the following steps:
/// 1. Creates an owned wavetable oscillator set at 110 Hz.
/// 2. Wait 3 seconds
/// 3. Outputs the oscillator to the left and right channels at 30% volume each.
/// 4. Waits for user to press ENTER.
///
/// Scheduling is currently limited to changes of constant values and spawning new nodes, not new
/// connections. This means you need to place all node and envelope creation inside the
/// schedule_bundle cAll.
///
fn main() -> Result<()> {
    let _backend = setup();

    schedule_bundle(graph::Time::Seconds(Seconds::new(3, 0)), || {
        let node0 = wavetable_oscillator_owned(Wavetable::sine()).freq(110.);
        graph_output(0, node0 * 0.3);
        graph_output(1, node0 * 0.3);
    });

    println!("Playing a sine wave at 110 Hz at an amplitude of 0.3, after 3 seconds");
    println!("Press [ENTER] to exit");
    let mut input = String::new();
    std::io::stdin().read_line(&mut input)?;
    Ok(())
}

/// Initializes the audio backend and starts a `KnystSphere` for audio processing.
/// Start with an automatic helper thread for scheduling changes and managing resources.
/// If you want to manage the `Controller` yourself, use `start_return_controller`.
///
/// The backend is returned here because it would otherwise be dropped at the end of setup()
fn setup() -> impl AudioBackend {
    let mut backend =
        CpalBackend::new(CpalBackendOptions::default()).expect("Unable to connect to CPAL backend");
    // Uncomment the line below and comment the line above to use the JACK backend instead
    // let mut backend = JackBackend::new("Knyst<3JACK").expect("Unable to start JACK backend");

    let _sphere_id = KnystSphere::start(
        &mut backend,
        SphereSettings {
            ..Default::default()
        },
        print_error_handler,
    )
    .ok();
    backend
}