opengate 0.3.1

An open-source toolset for consciousness expansion.
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

use log::warn;
use std::error::Error;

#[derive(Debug, Clone, Copy)]
pub enum AudioFormat {
    Wav,
    #[allow(dead_code)]
    Flac,
}

pub trait AudioSink {
    /// Write one interleaved stereo frame in range [-1.0, 1.0]
    fn write_frame(&mut self, left: f32, right: f32) -> Result<(), Box<dyn Error>>;
    /// Flush and finalize!
    fn finalize(self: Box<Self>) -> Result<(), Box<dyn Error>>;
}

/// For conversions from f32 to i16 for WAV
#[inline]
pub fn f32_to_i16(x: f32) -> i16 {
    let y = (x.clamp(-1.0, 1.0) * i16::MAX as f32).round();
    y as i16
}

pub use wav::WavSink;
mod wav;

#[cfg(feature = "flac")]
pub use flac::FlacSink;
#[cfg(feature = "flac")]
mod flac;

pub fn new_sink(out: &str, sample_rate: u32) -> Result<Box<dyn AudioSink>, Box<dyn Error>> {
    match detect_format_from_ext(out) {
        AudioFormat::Wav => WavSink::create(out, sample_rate),

        #[cfg(feature = "flac")]
        AudioFormat::Flac => FlacSink::create(out, sample_rate),

        #[allow(dead_code)]
        #[cfg(not(feature = "flac"))]
        AudioFormat::Flac => Err("FLAC support not enabled, build with `--features flac`".into()),
    }
}

/// Infer audio file format by file extension.
fn detect_format_from_ext(out: &str) -> AudioFormat {
    use std::path::Path;
    match Path::new(out)
        .extension()
        .and_then(|s| s.to_str())
        .unwrap_or("")
        .to_ascii_lowercase()
        .as_str()
    {
        #[cfg(feature = "flac")]
        "flac" => AudioFormat::Flac,

        #[allow(dead_code)]
        #[cfg(not(feature = "flac"))]
        "flac" => {
            warn!(
                "File extension was flac, however flac feature was not enabled during build. Using WAV."
            );
            AudioFormat::Wav
        }

        "wav" => AudioFormat::Wav,

        // In the future, let's error out. But WAV for now.
        other => {
            warn!(
                "File extension was {:?}, writing WAV (only wav and flav supported).",
                other
            );
            AudioFormat::Wav
        }
    }
}