Skip to main content

qualia_audio/io/resample/
anti_alias.rs

1//! Anti-alias lowpass cutoff design for sample-rate conversion.
2//!
3//! Delegated to [`etalon_signal::resample::antialias_cutoff_cycles`].
4
5/// Anti-alias lowpass cutoff in cycles per **source** sample (range `[0, 0.5]`).
6///
7/// Returns `0.0` for a degenerate zero rate. The consuming resamplers derive
8/// their sinc time-scale as `2 · cutoff` (`= min(1, dst/src)`).
9#[inline]
10pub fn antialias_cutoff(src_rate: u32, dst_rate: u32) -> f32 {
11    etalon_signal::resample::antialias_cutoff_cycles(src_rate, dst_rate)
12}
13
14#[cfg(test)]
15mod tests {
16    use super::*;
17
18    #[test]
19    fn upsample_passes_full_band() {
20        assert!((antialias_cutoff(8000, 48000) - 0.5).abs() < 1e-6);
21    }
22
23    #[test]
24    fn equal_rate_passes_full_band() {
25        assert!((antialias_cutoff(44100, 44100) - 0.5).abs() < 1e-6);
26    }
27
28    #[test]
29    fn downsample_lowers_cutoff_to_dst_nyquist() {
30        // 48k → 8k: cutoff = 0.5 · 8000/48000 = 0.08333… cycles/source-sample.
31        let c = antialias_cutoff(48000, 8000);
32        assert!((c - (0.5 * 8000.0 / 48000.0)).abs() < 1e-6, "got {c}");
33        assert!(c < 0.5);
34    }
35
36    #[test]
37    fn zero_rate_is_zero() {
38        assert_eq!(antialias_cutoff(0, 8000), 0.0);
39        assert_eq!(antialias_cutoff(8000, 0), 0.0);
40    }
41}