concord 2.3.1

A terminal user interface client for Discord
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use cpal::traits::DeviceTrait;

pub(crate) trait F32OutputSource {
    fn fill<T>(&mut self, output: &mut [T], channels: usize, convert: fn(f32) -> T)
    where
        T: Default + Copy;
}

pub(crate) fn build_f32_output_stream<S, E>(
    device: &cpal::Device,
    config: &cpal::StreamConfig,
    sample_format: cpal::SampleFormat,
    source: S,
    error_callback: E,
    unsupported_context: &str,
    build_context: &str,
) -> Result<cpal::Stream, String>
where
    S: F32OutputSource + Send + 'static,
    E: FnMut(cpal::StreamError) + Send + 'static,
{
    match sample_format {
        cpal::SampleFormat::F32 => build_f32_output_stream_as::<f32, _, _>(
            device,
            config,
            source,
            error_callback,
            clamp_f32_sample,
            build_context,
        ),
        cpal::SampleFormat::U8 => build_f32_output_stream_as::<u8, _, _>(
            device,
            config,
            source,
            error_callback,
            f32_sample_to_u8,
            build_context,
        ),
        cpal::SampleFormat::I16 => build_f32_output_stream_as::<i16, _, _>(
            device,
            config,
            source,
            error_callback,
            f32_sample_to_i16,
            build_context,
        ),
        cpal::SampleFormat::U16 => build_f32_output_stream_as::<u16, _, _>(
            device,
            config,
            source,
            error_callback,
            f32_sample_to_u16,
            build_context,
        ),
        other => Err(format!(
            "unsupported {unsupported_context} sample format: {other:?}"
        )),
    }
}

fn build_f32_output_stream_as<T, S, E>(
    device: &cpal::Device,
    config: &cpal::StreamConfig,
    mut source: S,
    error_callback: E,
    convert: fn(f32) -> T,
    build_context: &str,
) -> Result<cpal::Stream, String>
where
    T: cpal::SizedSample + Default + Copy + 'static,
    S: F32OutputSource + Send + 'static,
    E: FnMut(cpal::StreamError) + Send + 'static,
{
    let channels = usize::from(config.channels.max(1));
    device
        .build_output_stream(
            config,
            move |output: &mut [T], _| source.fill(output, channels, convert),
            error_callback,
            None,
        )
        .map_err(|error| format!("{build_context} output stream build failed: {error}"))
}

pub(crate) fn clamp_f32_sample(sample: f32) -> f32 {
    sample.clamp(-1.0, 1.0)
}

pub(crate) fn f32_sample_to_u8(sample: f32) -> u8 {
    ((clamp_f32_sample(sample) + 1.0) * 0.5 * f32::from(u8::MAX)).round() as u8
}

pub(crate) fn f32_sample_to_i16(sample: f32) -> i16 {
    (clamp_f32_sample(sample) * f32::from(i16::MAX)).round() as i16
}

pub(crate) fn f32_sample_to_u16(sample: f32) -> u16 {
    ((clamp_f32_sample(sample) + 1.0) * 0.5 * f32::from(u16::MAX)).round() as u16
}

#[cfg(test)]
mod tests {
    use super::{f32_sample_to_i16, f32_sample_to_u8, f32_sample_to_u16};

    #[test]
    fn converts_f32_samples_to_integer_output_ranges() {
        assert_eq!(f32_sample_to_u8(1.0), u8::MAX);
        assert_eq!(f32_sample_to_u8(-1.0), 0);
        assert_eq!(f32_sample_to_i16(1.0), i16::MAX);
        assert_eq!(f32_sample_to_i16(-1.0), -i16::MAX);
        assert_eq!(f32_sample_to_u16(1.0), u16::MAX);
        assert_eq!(f32_sample_to_u16(-1.0), 0);
    }
}