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

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

//! Endomorph body type morph — rounder, higher body-fat build.

/// Configuration for the endomorph morph.
#[derive(Debug, Clone)]
pub struct EndomorphConfig {
    pub belly_fullness: f32,
    pub limb_girth: f32,
    pub face_roundness: f32,
}

impl Default for EndomorphConfig {
    fn default() -> Self {
        EndomorphConfig {
            belly_fullness: 0.8,
            limb_girth: 0.6,
            face_roundness: 0.7,
        }
    }
}

/// State for the endomorph morph.
#[derive(Debug, Clone)]
pub struct EndomorphMorph {
    pub intensity: f32,
    pub config: EndomorphConfig,
    pub enabled: bool,
}

/// Create a new endomorph morph.
pub fn new_endomorph_morph() -> EndomorphMorph {
    EndomorphMorph {
        intensity: 0.0,
        config: EndomorphConfig::default(),
        enabled: true,
    }
}

/// Set intensity [0, 1].
pub fn endo_set_intensity(m: &mut EndomorphMorph, v: f32) {
    m.intensity = v.clamp(0.0, 1.0);
}

/// Belly fullness weight.
pub fn endo_belly_weight(m: &EndomorphMorph) -> f32 {
    m.intensity * m.config.belly_fullness
}

/// Limb girth weight.
pub fn endo_limb_girth(m: &EndomorphMorph) -> f32 {
    m.intensity * m.config.limb_girth
}

/// Face roundness weight.
pub fn endo_face_roundness(m: &EndomorphMorph) -> f32 {
    m.intensity * m.config.face_roundness
}

/// Serialise to JSON.
pub fn endo_to_json(m: &EndomorphMorph) -> String {
    format!(
        r#"{{"intensity":{:.3},"belly":{:.3},"enabled":{}}}"#,
        m.intensity,
        endo_belly_weight(m),
        m.enabled
    )
}

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

    #[test]
    fn default_zero() {
        let m = new_endomorph_morph();
        assert!((m.intensity - 0.0).abs() < 1e-6 /* zero */);
    }

    #[test]
    fn clamp_to_one() {
        let mut m = new_endomorph_morph();
        endo_set_intensity(&mut m, 2.0);
        assert!((m.intensity - 1.0).abs() < 1e-6 /* clamped */);
    }

    #[test]
    fn belly_weight_at_full() {
        let mut m = new_endomorph_morph();
        endo_set_intensity(&mut m, 1.0);
        assert!((endo_belly_weight(&m) - m.config.belly_fullness).abs() < 1e-6 /* correct */);
    }

    #[test]
    fn limb_girth_zero_at_zero() {
        let m = new_endomorph_morph();
        assert!((endo_limb_girth(&m) - 0.0).abs() < 1e-6 /* zero */);
    }

    #[test]
    fn face_roundness_increasing() {
        let mut m = new_endomorph_morph();
        endo_set_intensity(&mut m, 0.5);
        let r5 = endo_face_roundness(&m);
        endo_set_intensity(&mut m, 1.0);
        let r10 = endo_face_roundness(&m);
        assert!(r10 > r5 /* more round at higher intensity */);
    }

    #[test]
    fn json_has_belly() {
        let mut m = new_endomorph_morph();
        endo_set_intensity(&mut m, 0.6);
        assert!(endo_to_json(&m).contains("belly") /* json has belly key */);
    }

    #[test]
    fn enabled_default() {
        let m = new_endomorph_morph();
        assert!(m.enabled /* enabled */);
    }

    #[test]
    fn config_limb_girth_positive() {
        let m = new_endomorph_morph();
        assert!(m.config.limb_girth > 0.0 /* valid */);
    }
}