ff-filter 0.14.2

Video and audio filter graph operations - the Rust way
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

/// A value that supports linear component-wise interpolation.
///
/// `t = 0.0` returns a clone of `a`; `t = 1.0` returns a clone of `b`.
///
/// Implementations for `(f64, f64)` and `(f64, f64, f64)` are added
/// in issue #351.
pub trait Lerp: Clone {
    /// Linearly interpolates between `a` and `b` by the factor `t`.
    fn lerp(a: &Self, b: &Self, t: f64) -> Self;
}

impl Lerp for f64 {
    fn lerp(a: &Self, b: &Self, t: f64) -> Self {
        a + (b - a) * t
    }
}

impl Lerp for (f64, f64) {
    fn lerp(a: &Self, b: &Self, t: f64) -> Self {
        (f64::lerp(&a.0, &b.0, t), f64::lerp(&a.1, &b.1, t))
    }
}

impl Lerp for (f64, f64, f64) {
    fn lerp(a: &Self, b: &Self, t: f64) -> Self {
        (
            f64::lerp(&a.0, &b.0, t),
            f64::lerp(&a.1, &b.1, t),
            f64::lerp(&a.2, &b.2, t),
        )
    }
}

// ── Tests ─────────────────────────────────────────────────────────────────────

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn lerp_tuple2d_should_interpolate_both_components() {
        let a = (0.0_f64, 10.0_f64);
        let b = (100.0_f64, 50.0_f64);

        let mid = <(f64, f64)>::lerp(&a, &b, 0.5);
        assert!(
            (mid.0 - 50.0).abs() < f64::EPSILON,
            "x: expected 50.0, got {}",
            mid.0
        );
        assert!(
            (mid.1 - 30.0).abs() < f64::EPSILON,
            "y: expected 30.0, got {}",
            mid.1
        );

        let start = <(f64, f64)>::lerp(&a, &b, 0.0);
        assert!((start.0 - 0.0).abs() < f64::EPSILON);
        assert!((start.1 - 10.0).abs() < f64::EPSILON);

        let end = <(f64, f64)>::lerp(&a, &b, 1.0);
        assert!((end.0 - 100.0).abs() < f64::EPSILON);
        assert!((end.1 - 50.0).abs() < f64::EPSILON);
    }

    #[test]
    fn lerp_tuple3d_should_interpolate_all_components() {
        let a = (0.0_f64, 0.0_f64, 0.0_f64);
        let b = (255.0_f64, 128.0_f64, 64.0_f64);

        let mid = <(f64, f64, f64)>::lerp(&a, &b, 0.5);
        assert!(
            (mid.0 - 127.5).abs() < f64::EPSILON,
            "r: expected 127.5, got {}",
            mid.0
        );
        assert!(
            (mid.1 - 64.0).abs() < f64::EPSILON,
            "g: expected 64.0, got {}",
            mid.1
        );
        assert!(
            (mid.2 - 32.0).abs() < f64::EPSILON,
            "b: expected 32.0, got {}",
            mid.2
        );

        let start = <(f64, f64, f64)>::lerp(&a, &b, 0.0);
        assert!((start.0).abs() < f64::EPSILON);
        assert!((start.1).abs() < f64::EPSILON);
        assert!((start.2).abs() < f64::EPSILON);

        let end = <(f64, f64, f64)>::lerp(&a, &b, 1.0);
        assert!((end.0 - 255.0).abs() < f64::EPSILON);
        assert!((end.1 - 128.0).abs() < f64::EPSILON);
        assert!((end.2 - 64.0).abs() < f64::EPSILON);
    }
}