Skip to main content

qualia_audio/fx/stereo/
demux.rs

1//! Deinterleave an interleaved stereo buffer into two mono channels.
2//!
3//! `left[i] = in[2i]`, `right[i] = in[2i+1]`. Delegated to [`etalon_signal::reverb::stereo_demux_into`].
4
5use crate::types::AudioError;
6
7/// Split interleaved stereo `interleaved` (L,R,L,R,…) into `left` / `right`.
8///
9/// Processes `n = min(interleaved.len()/2, left.len(), right.len())` frames and
10/// returns the frame count. Errors if `left` or `right` cannot hold the frames
11/// available in `interleaved`.
12pub fn demux(
13    interleaved: &[f32],
14    left: &mut [f32],
15    right: &mut [f32],
16) -> Result<usize, AudioError> {
17    let frames = interleaved.len() / 2;
18    if left.len() < frames || right.len() < frames {
19        return Err(AudioError::OutputBufferTooSmall);
20    }
21    Ok(etalon_signal::reverb::stereo_demux_into(
22        interleaved, left, right,
23    ))
24}
25
26#[cfg(test)]
27mod tests {
28    use super::*;
29
30    #[test]
31    fn deinterleaves_in_order() {
32        let inter = [1.0f32, 2.0, 3.0, 4.0, 5.0, 6.0];
33        let mut l = [0.0f32; 3];
34        let mut r = [0.0f32; 3];
35        let n = demux(&inter, &mut l, &mut r).unwrap();
36        assert_eq!(n, 3);
37        assert_eq!(l, [1.0, 3.0, 5.0]);
38        assert_eq!(r, [2.0, 4.0, 6.0]);
39    }
40
41    #[test]
42    fn out_too_small_errors() {
43        let inter = [1.0f32, 2.0, 3.0, 4.0];
44        let mut l = [0.0f32; 1];
45        let mut r = [0.0f32; 2];
46        assert_eq!(
47            demux(&inter, &mut l, &mut r),
48            Err(AudioError::OutputBufferTooSmall)
49        );
50    }
51}