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

//! Carpal bone arrangement morph — wrist thickness and intercarpal spacing.

/// Carpals morph configuration.
#[derive(Debug, Clone)]
pub struct CarpalsMorph {
    pub width: f32,
    pub height: f32,
    pub spacing: f32,
    pub tunnel_depth: f32,
}

impl CarpalsMorph {
    pub fn new() -> Self {
        Self {
            width: 0.5,
            height: 0.5,
            spacing: 0.5,
            tunnel_depth: 0.5,
        }
    }
}

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

/// Create a new carpals morph.
pub fn new_carpals_morph() -> CarpalsMorph {
    CarpalsMorph::new()
}

/// Set carpal arch width.
pub fn carp_set_width(m: &mut CarpalsMorph, v: f32) {
    m.width = v.clamp(0.0, 1.0);
}

/// Set carpal arch height.
pub fn carp_set_height(m: &mut CarpalsMorph, v: f32) {
    m.height = v.clamp(0.0, 1.0);
}

/// Set intercarpal spacing.
pub fn carp_set_spacing(m: &mut CarpalsMorph, v: f32) {
    m.spacing = v.clamp(0.0, 1.0);
}

/// Set carpal tunnel depth.
pub fn carp_set_tunnel_depth(m: &mut CarpalsMorph, v: f32) {
    m.tunnel_depth = v.clamp(0.0, 1.0);
}

/// Carpal tunnel cross-sectional area estimate.
pub fn carp_tunnel_area(m: &CarpalsMorph) -> f32 {
    m.width * m.tunnel_depth
}

/// Serialize to JSON-like string.
pub fn carpals_morph_to_json(m: &CarpalsMorph) -> String {
    format!(
        r#"{{"width":{:.4},"height":{:.4},"spacing":{:.4},"tunnel_depth":{:.4}}}"#,
        m.width, m.height, m.spacing, m.tunnel_depth
    )
}

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

    #[test]
    fn test_defaults() {
        let m = new_carpals_morph();
        assert!((m.width - 0.5).abs() < 1e-6);
        assert!((m.tunnel_depth - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_width_clamp() {
        let mut m = new_carpals_morph();
        carp_set_width(&mut m, 5.0);
        assert_eq!(m.width, 1.0);
    }

    #[test]
    fn test_height_set() {
        let mut m = new_carpals_morph();
        carp_set_height(&mut m, 0.7);
        assert!((m.height - 0.7).abs() < 1e-6);
    }

    #[test]
    fn test_spacing_set() {
        let mut m = new_carpals_morph();
        carp_set_spacing(&mut m, 0.3);
        assert!((m.spacing - 0.3).abs() < 1e-6);
    }

    #[test]
    fn test_tunnel_depth_clamp() {
        let mut m = new_carpals_morph();
        carp_set_tunnel_depth(&mut m, -1.0);
        assert_eq!(m.tunnel_depth, 0.0);
    }

    #[test]
    fn test_tunnel_area_positive() {
        let m = new_carpals_morph();
        assert!(carp_tunnel_area(&m) > 0.0);
    }

    #[test]
    fn test_tunnel_area_zero() {
        let mut m = new_carpals_morph();
        carp_set_width(&mut m, 0.0);
        assert_eq!(carp_tunnel_area(&m), 0.0);
    }

    #[test]
    fn test_json_keys() {
        let m = new_carpals_morph();
        let s = carpals_morph_to_json(&m);
        assert!(s.contains("tunnel_depth"));
    }

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