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
137
138

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

//! Child body proportion morph (ages 2–12).

/// Configuration for the child morph.
#[derive(Debug, Clone)]
pub struct ChildMorphConfig {
    pub limb_elongation: f32,
    pub torso_narrowness: f32,
    pub head_ratio: f32,
}

impl Default for ChildMorphConfig {
    fn default() -> Self {
        ChildMorphConfig {
            limb_elongation: 0.7,
            torso_narrowness: 0.85,
            head_ratio: 0.85,
        }
    }
}

/// State for the child body morph.
#[derive(Debug, Clone)]
pub struct ChildMorph {
    /// Age in years (2–12).
    pub age_years: f32,
    pub config: ChildMorphConfig,
    pub enabled: bool,
}

/// Create a new child morph at age 2.
pub fn new_child_morph() -> ChildMorph {
    ChildMorph {
        age_years: 2.0,
        config: ChildMorphConfig::default(),
        enabled: true,
    }
}

/// Set age in years (clamped to 2–12).
pub fn cm_set_age(m: &mut ChildMorph, years: f32) {
    m.age_years = years.clamp(2.0, 12.0);
}

/// Normalised progress (0 = age 2, 1 = age 12).
pub fn cm_progress(m: &ChildMorph) -> f32 {
    (m.age_years - 2.0) / 10.0
}

/// Body height scale factor relative to adult norm.
pub fn cm_height_scale(m: &ChildMorph) -> f32 {
    0.45 + 0.35 * cm_progress(m)
}

/// Limb length scale.
pub fn cm_limb_scale(m: &ChildMorph) -> f32 {
    m.config.limb_elongation + 0.15 * cm_progress(m)
}

/// Serialise to JSON.
pub fn cm_to_json(m: &ChildMorph) -> String {
    format!(
        r#"{{"age_years":{:.1},"height_scale":{:.3},"enabled":{}}}"#,
        m.age_years,
        cm_height_scale(m),
        m.enabled
    )
}

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

    #[test]
    fn default_age_is_two() {
        let m = new_child_morph();
        assert!((m.age_years - 2.0).abs() < 1e-6 /* default age 2 */);
    }

    #[test]
    fn set_age_clamps_bounds() {
        let mut m = new_child_morph();
        cm_set_age(&mut m, 0.0);
        assert!((m.age_years - 2.0).abs() < 1e-6 /* clamped to 2 */);
        cm_set_age(&mut m, 99.0);
        assert!((m.age_years - 12.0).abs() < 1e-6 /* clamped to 12 */);
    }

    #[test]
    fn progress_at_age_12_is_one() {
        let mut m = new_child_morph();
        cm_set_age(&mut m, 12.0);
        assert!((cm_progress(&m) - 1.0).abs() < 1e-6 /* full progress */);
    }

    #[test]
    fn height_increases_with_age() {
        let mut m = new_child_morph();
        cm_set_age(&mut m, 2.0);
        let h2 = cm_height_scale(&m);
        cm_set_age(&mut m, 12.0);
        let h12 = cm_height_scale(&m);
        assert!(h12 > h2 /* taller at 12 */);
    }

    #[test]
    fn limb_scale_increases() {
        let mut m = new_child_morph();
        cm_set_age(&mut m, 2.0);
        let l2 = cm_limb_scale(&m);
        cm_set_age(&mut m, 12.0);
        let l12 = cm_limb_scale(&m);
        assert!(l12 > l2 /* longer limbs at 12 */);
    }

    #[test]
    fn json_contains_age() {
        let mut m = new_child_morph();
        cm_set_age(&mut m, 8.0);
        assert!(cm_to_json(&m).contains("8.0") /* age in json */);
    }

    #[test]
    fn enabled_flag_works() {
        let mut m = new_child_morph();
        m.enabled = false;
        assert!(!m.enabled /* disabled */);
    }

    #[test]
    fn torso_narrowness_positive() {
        let m = new_child_morph();
        assert!(m.config.torso_narrowness > 0.0 /* valid config */);
    }
}