atome 0.8.0

An async, `cpal`-based audio engine for Rust. `atome` gives you a small, composable API for building real-time audio applications — sample playback, mixing, routing, and DSP graphs — without wrestling with platform audio callbacks, device enumeration, or buffer management yourself.
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

//! Random input to random output.
//!
//! The smallest engine there is: one capture device, one playback device, no
//! routing and no plugins. Both are picked at random from whatever this machine
//! has, so on a laptop with several interfaces two runs give different
//! pairings — the point being that nothing in the engine cares which.
//!
//! ```sh
//! make example1
//! ```

use atome::device::AtomeDevice;
use atome::output::SampleRate;
use atome::{input, output, AudioEngine};

mod common;

fn main() -> Result<(), cpal::Error> {
    let inputs = input::list_devices(None)?;
    let outputs = output::list_devices(None)?;

    let Some(input) = common::pick(&inputs) else {
        eprintln!("no input devices on this machine");
        return Ok(());
    };
    let Some(output) = common::pick(&outputs) else {
        eprintln!("no output devices on this machine");
        return Ok(());
    };

    println!("picked at random:");
    println!("  in   {}", common::name_of(input));
    println!("  out  {}", common::name_of(output));

    let engine = AudioEngine::<f32>::new(
        vec![AtomeDevice::input(input.clone(), common::host())],
        vec![AtomeDevice::output(output.clone(), common::host())],
        SampleRate::Hz48k,
        // One count per output device, and there is one output.
        vec![2],
        Some(512),
        vec![],
    )?;

    common::describe(&engine);

    // Nothing named a route, so the input feeds every output — here, the one.
    println!(
        "\nunrouted input reaches every output: {:?}",
        engine.inputs()[0].routes()
    );

    common::note_no_audio();
    Ok(())
}