rill-io 0.5.0-beta.1

Audio I/O backends for Rill - CPAL, ALSA, PipeWire, JACK
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! Audio I/O backends for Rill
//!
//! This crate provides a unified interface to various audio backends
//! (ALSA, CPAL, PipeWire, JACK). Graph processing is handled by
//! `rill-graph` — this crate is purely about hardware I/O.

#![warn(missing_docs)]

mod backend;
pub mod buffer;
mod config;
mod error;

pub mod backends;

/// MIDI event types for I/O backends.
pub mod midi;

/// Audio output sink node (stereo, bridge to hardware).
pub mod output;

/// Audio input source node (stereo, bridge from hardware).
pub mod input;

/// Abstract audio I/O backend + registry.
pub mod audio_io;

/// Shared ring buffers and downcast helpers for I/O nodes.
pub mod rings;

/// Global PipeWire context (lazily initialised, shared by I/O nodes).
pub mod pw;

pub use backend::{AudioBackend, BackendType, DeviceInfo};
pub use config::AudioConfig;
pub use error::{IoError, IoResult};
pub use midi::MidiEvent;
pub use output::AudioOutput;
pub use input::AudioInput;
pub use rings::PwBuffers;

pub use backends::NullBackend;

#[cfg(feature = "cpal")]
pub use backends::CpalBackend;

#[cfg(feature = "alsa")]
pub use backends::AlsaBackend;

#[cfg(feature = "pipewire")]
pub use backends::PipewireBackend;

#[cfg(feature = "jack")]
pub use backends::JackBackend;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_config_default() {
        let config = AudioConfig::default();
        assert_eq!(config.sample_rate, 48000);
        assert_eq!(config.buffer_size, 256);
        assert_eq!(config.input_channels, 2);
        assert_eq!(config.output_channels, 2);
    }

    #[test]
    fn test_config_with_methods() {
        let config = AudioConfig::new()
            .with_sample_rate(44100)
            .with_buffer_size(512)
            .with_channels(1);
        assert_eq!(config.sample_rate, 44100);
        assert_eq!(config.buffer_size, 512);
    }

    #[test]
    fn test_latency_calculation() {
        let config = AudioConfig::new()
            .with_sample_rate(48000)
            .with_buffer_size(256);
        let latency_sec = config.latency_seconds();
        let latency_ms = config.latency_ms();
        assert!((latency_sec - 256.0 / 48000.0).abs() < 1e-10);
        assert!((latency_ms - 256.0 * 1000.0 / 48000.0).abs() < 1e-10);
    }
}