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)]

//! Gynoid body proportion morph — weight centred lower body/hips.

/// Configuration for the gynoid proportion morph.
#[derive(Debug, Clone)]
pub struct GynoidProportionConfig {
    pub hip_fullness: f32,
    pub thigh_girth: f32,
    pub upper_body_slim: f32,
}

impl Default for GynoidProportionConfig {
    fn default() -> Self {
        GynoidProportionConfig {
            hip_fullness: 0.8,
            thigh_girth: 0.7,
            upper_body_slim: 0.5,
        }
    }
}

/// State for the gynoid proportion morph.
#[derive(Debug, Clone)]
pub struct GynoidProportion {
    pub intensity: f32,
    pub config: GynoidProportionConfig,
    pub enabled: bool,
}

/// Create a new gynoid proportion morph.
pub fn new_gynoid_proportion() -> GynoidProportion {
    GynoidProportion {
        intensity: 0.0,
        config: GynoidProportionConfig::default(),
        enabled: true,
    }
}

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

/// Hip fullness weight.
pub fn gyn_hip_fullness(m: &GynoidProportion) -> f32 {
    m.intensity * m.config.hip_fullness
}

/// Thigh girth weight.
pub fn gyn_thigh_girth(m: &GynoidProportion) -> f32 {
    m.intensity * m.config.thigh_girth
}

/// Upper body slimming weight.
pub fn gyn_upper_slim(m: &GynoidProportion) -> f32 {
    m.intensity * m.config.upper_body_slim
}

/// Serialise to JSON.
pub fn gyn_to_json(m: &GynoidProportion) -> String {
    format!(
        r#"{{"intensity":{:.3},"hip_fullness":{:.3},"enabled":{}}}"#,
        m.intensity,
        gyn_hip_fullness(m),
        m.enabled
    )
}

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

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

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

    #[test]
    fn hip_fullness_at_max() {
        let mut m = new_gynoid_proportion();
        gyn_set_intensity(&mut m, 1.0);
        assert!((gyn_hip_fullness(&m) - m.config.hip_fullness).abs() < 1e-6 /* correct */);
    }

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

    #[test]
    fn upper_slim_increases() {
        let mut m = new_gynoid_proportion();
        gyn_set_intensity(&mut m, 0.5);
        let s5 = gyn_upper_slim(&m);
        gyn_set_intensity(&mut m, 1.0);
        let s10 = gyn_upper_slim(&m);
        assert!(s10 > s5 /* more slim at higher intensity */);
    }

    #[test]
    fn json_has_intensity() {
        let mut m = new_gynoid_proportion();
        gyn_set_intensity(&mut m, 0.3);
        assert!(gyn_to_json(&m).contains("0.300") /* intensity in json */);
    }

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

    #[test]
    fn thigh_girth_config_positive() {
        let m = new_gynoid_proportion();
        assert!(m.config.thigh_girth > 0.0 /* valid */);
    }
}