Skip to main content

qualia_audio/fx/stereo/
mux.rs

1//! Interleave two mono channels into an interleaved stereo buffer.
2//!
3//! `out[2i] = left[i]`, `out[2i+1] = right[i]`. Delegated to [`etalon_signal::reverb::stereo_mux_into`].
4
5use crate::types::AudioError;
6
7/// Interleave `left` and `right` mono channels into `out` (L,R,L,R,…).
8///
9/// Processes `n = min(left.len(), right.len())` frames. Returns the frame count.
10/// Errors with [`AudioError::OutputBufferTooSmall`] if `out.len() < 2·n`.
11pub fn mux(left: &[f32], right: &[f32], out: &mut [f32]) -> Result<usize, AudioError> {
12    let n = left.len().min(right.len());
13    if out.len() < n * 2 {
14        return Err(AudioError::OutputBufferTooSmall);
15    }
16    Ok(etalon_signal::reverb::stereo_mux_into(left, right, out))
17}
18
19#[cfg(test)]
20mod tests {
21    use super::*;
22    use crate::fx::stereo::demux::demux;
23
24    #[test]
25    fn interleaves_in_order() {
26        let l = [1.0f32, 3.0, 5.0];
27        let r = [2.0f32, 4.0, 6.0];
28        let mut out = [0.0f32; 6];
29        let n = mux(&l, &r, &mut out).unwrap();
30        assert_eq!(n, 3);
31        assert_eq!(out, [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]);
32    }
33
34    #[test]
35    fn mux_then_demux_is_identity() {
36        let l: Vec<f32> = (0..64).map(|i| (i as f32 * 0.013).sin()).collect();
37        let r: Vec<f32> = (0..64).map(|i| (i as f32 * 0.031).cos()).collect();
38        let mut inter = vec![0.0f32; 128];
39        let n = mux(&l, &r, &mut inter).unwrap();
40        assert_eq!(n, 64);
41        let mut l2 = vec![0.0f32; 64];
42        let mut r2 = vec![0.0f32; 64];
43        let m = demux(&inter, &mut l2, &mut r2).unwrap();
44        assert_eq!(m, 64);
45        for i in 0..64 {
46            assert!((l[i] - l2[i]).abs() < 1e-9);
47            assert!((r[i] - r2[i]).abs() < 1e-9);
48        }
49    }
50
51    #[test]
52    fn out_too_small_errors() {
53        let l = [1.0f32, 2.0];
54        let r = [3.0f32, 4.0];
55        let mut out = [0.0f32; 2];
56        assert_eq!(mux(&l, &r, &mut out), Err(AudioError::OutputBufferTooSmall));
57    }
58}