oxihuman-morph 0.1.2

Parametric morphology engine for human body generation — targets, blendshapes, FACS
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128

#![allow(dead_code)]

/// A parameter range with min/max bounds.
#[allow(dead_code)]
#[derive(Debug, Clone, Copy)]
pub struct ParamRange {
    pub min: f32,
    pub max: f32,
}

#[allow(dead_code)]
pub fn new_param_range(min: f32, max: f32) -> ParamRange {
    let (lo, hi) = if min <= max { (min, max) } else { (max, min) };
    ParamRange { min: lo, max: hi }
}

#[allow(dead_code)]
pub fn range_min(r: &ParamRange) -> f32 { r.min }

#[allow(dead_code)]
pub fn range_max(r: &ParamRange) -> f32 { r.max }

#[allow(dead_code)]
pub fn range_contains(r: &ParamRange, val: f32) -> bool {
    (r.min..=r.max).contains(&val)
}

#[allow(dead_code)]
pub fn range_clamp(r: &ParamRange, val: f32) -> f32 {
    val.clamp(r.min, r.max)
}

#[allow(dead_code)]
pub fn range_normalize(r: &ParamRange, val: f32) -> f32 {
    let span = r.max - r.min;
    if span.abs() < 1e-9 { return 0.0; }
    (val - r.min) / span
}

#[allow(dead_code)]
pub fn range_lerp(r: &ParamRange, t: f32) -> f32 {
    r.min + (r.max - r.min) * t
}

#[allow(dead_code)]
pub fn range_to_json(r: &ParamRange) -> String {
    format!("{{\"min\":{:.4},\"max\":{:.4}}}", r.min, r.max)
}

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

    #[test]
    fn test_new() {
        let r = new_param_range(0.0, 1.0);
        assert!((r.min).abs() < 1e-6);
        assert!((r.max - 1.0).abs() < 1e-6);
    }

    #[test]
    fn test_new_reversed() {
        let r = new_param_range(5.0, 2.0);
        assert!((r.min - 2.0).abs() < 1e-6);
        assert!((r.max - 5.0).abs() < 1e-6);
    }

    #[test]
    fn test_contains() {
        let r = new_param_range(0.0, 1.0);
        assert!(range_contains(&r, 0.5));
        assert!(range_contains(&r, 0.0));
        assert!(range_contains(&r, 1.0));
        assert!(!range_contains(&r, 1.1));
    }

    #[test]
    fn test_clamp() {
        let r = new_param_range(0.0, 1.0);
        assert!((range_clamp(&r, -0.5)).abs() < 1e-6);
        assert!((range_clamp(&r, 1.5) - 1.0).abs() < 1e-6);
        assert!((range_clamp(&r, 0.5) - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_normalize() {
        let r = new_param_range(0.0, 10.0);
        assert!((range_normalize(&r, 5.0) - 0.5).abs() < 1e-6);
        assert!((range_normalize(&r, 0.0)).abs() < 1e-6);
        assert!((range_normalize(&r, 10.0) - 1.0).abs() < 1e-6);
    }

    #[test]
    fn test_lerp() {
        let r = new_param_range(0.0, 10.0);
        assert!((range_lerp(&r, 0.0)).abs() < 1e-6);
        assert!((range_lerp(&r, 0.5) - 5.0).abs() < 1e-6);
        assert!((range_lerp(&r, 1.0) - 10.0).abs() < 1e-6);
    }

    #[test]
    fn test_to_json() {
        let r = new_param_range(0.0, 1.0);
        let j = range_to_json(&r);
        assert!(j.contains("min"));
        assert!(j.contains("max"));
    }

    #[test]
    fn test_min_max_accessors() {
        let r = new_param_range(3.0, 7.0);
        assert!((range_min(&r) - 3.0).abs() < 1e-6);
        assert!((range_max(&r) - 7.0).abs() < 1e-6);
    }

    #[test]
    fn test_normalize_zero_span() {
        let r = new_param_range(5.0, 5.0);
        assert!((range_normalize(&r, 5.0)).abs() < 1e-6);
    }

    #[test]
    fn test_lerp_endpoints() {
        let r = new_param_range(-1.0, 1.0);
        assert!((range_lerp(&r, 0.0) - (-1.0)).abs() < 1e-6);
        assert!((range_lerp(&r, 1.0) - 1.0).abs() < 1e-6);
    }
}