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
129
130
131
132
133
134
135
136

// Copyright (C) 2026 COOLJAPAN OU (Team KitaSan)
// SPDX-License-Identifier: Apache-2.0
#![allow(dead_code)]

//! Diaphragm position morph — controls dome height, descent, and excursion range.

/// Diaphragm morph configuration.
#[derive(Debug, Clone)]
pub struct DiaphragmMorph {
    pub dome_height: f32,
    pub descent: f32,
    pub excursion_range: f32,
    pub contraction: f32,
}

impl DiaphragmMorph {
    pub fn new() -> Self {
        Self {
            dome_height: 0.5,
            descent: 0.0,
            excursion_range: 0.5,
            contraction: 0.0,
        }
    }
}

impl Default for DiaphragmMorph {
    fn default() -> Self {
        Self::new()
    }
}

/// Create a new diaphragm morph.
pub fn new_diaphragm_morph() -> DiaphragmMorph {
    DiaphragmMorph::new()
}

/// Set diaphragm dome height.
pub fn diaphragm_set_dome_height(m: &mut DiaphragmMorph, v: f32) {
    m.dome_height = v.clamp(0.0, 1.0);
}

/// Set inspiratory descent (contraction lowers dome).
pub fn diaphragm_set_descent(m: &mut DiaphragmMorph, v: f32) {
    m.descent = v.clamp(0.0, 1.0);
}

/// Set excursion range during breathing cycle.
pub fn diaphragm_set_excursion_range(m: &mut DiaphragmMorph, v: f32) {
    m.excursion_range = v.clamp(0.0, 1.0);
}

/// Set muscle contraction level.
pub fn diaphragm_set_contraction(m: &mut DiaphragmMorph, v: f32) {
    m.contraction = v.clamp(0.0, 1.0);
}

/// Effective dome position after descent.
pub fn diaphragm_effective_dome(m: &DiaphragmMorph) -> f32 {
    (m.dome_height - m.descent * 0.5).max(0.0)
}

/// Serialize to JSON-like string.
pub fn diaphragm_morph_to_json(m: &DiaphragmMorph) -> String {
    format!(
        r#"{{"dome_height":{:.4},"descent":{:.4},"excursion_range":{:.4},"contraction":{:.4}}}"#,
        m.dome_height, m.descent, m.excursion_range, m.contraction
    )
}

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

    #[test]
    fn test_defaults() {
        let m = new_diaphragm_morph();
        assert!((m.dome_height - 0.5).abs() < 1e-6);
        assert_eq!(m.descent, 0.0);
    }

    #[test]
    fn test_dome_height_clamp() {
        let mut m = new_diaphragm_morph();
        diaphragm_set_dome_height(&mut m, 2.0);
        assert_eq!(m.dome_height, 1.0);
    }

    #[test]
    fn test_descent() {
        let mut m = new_diaphragm_morph();
        diaphragm_set_descent(&mut m, 0.6);
        assert!((m.descent - 0.6).abs() < 1e-6);
    }

    #[test]
    fn test_effective_dome_neutral() {
        let m = new_diaphragm_morph();
        assert!((diaphragm_effective_dome(&m) - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_effective_dome_lowered() {
        let mut m = new_diaphragm_morph();
        diaphragm_set_descent(&mut m, 1.0);
        assert!(diaphragm_effective_dome(&m) < 0.5); /* dome lowered */
    }

    #[test]
    fn test_excursion_range() {
        let mut m = new_diaphragm_morph();
        diaphragm_set_excursion_range(&mut m, 0.8);
        assert!((m.excursion_range - 0.8).abs() < 1e-6);
    }

    #[test]
    fn test_contraction_clamp() {
        let mut m = new_diaphragm_morph();
        diaphragm_set_contraction(&mut m, -1.0);
        assert_eq!(m.contraction, 0.0);
    }

    #[test]
    fn test_json_keys() {
        let m = new_diaphragm_morph();
        let s = diaphragm_morph_to_json(&m);
        assert!(s.contains("excursion_range"));
    }

    #[test]
    fn test_clone() {
        let m = new_diaphragm_morph();
        let m2 = m.clone();
        assert!((m2.dome_height - m.dome_height).abs() < 1e-6);
    }
}