oxihuman-export 0.1.2

Export pipeline for OxiHuman — glTF, COLLADA, STL, and streaming formats
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

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

//! Export decal projector settings.

#[allow(dead_code)]
pub struct DecalExport {
    pub name: String,
    pub texture: String,
    pub position: [f32; 3],
    pub normal: [f32; 3],
    pub size: [f32; 2],
    pub depth: f32,
    pub opacity: f32,
}

#[allow(dead_code)]
pub fn default_decal_export(name: &str) -> DecalExport {
    DecalExport {
        name: name.to_string(),
        texture: "decal_default.png".to_string(),
        position: [0.0, 0.0, 0.0],
        normal: [0.0, 1.0, 0.0],
        size: [1.0, 1.0],
        depth: 0.5,
        opacity: 1.0,
    }
}

#[allow(dead_code)]
pub fn export_decal_to_json(d: &DecalExport) -> String {
    format!(
        "{{\"name\":\"{}\",\"texture\":\"{}\",\"position\":[{},{},{}],\"normal\":[{},{},{}],\"size\":[{},{}],\"depth\":{},\"opacity\":{}}}",
        d.name, d.texture,
        d.position[0], d.position[1], d.position[2],
        d.normal[0], d.normal[1], d.normal[2],
        d.size[0], d.size[1],
        d.depth, d.opacity
    )
}

/// Returns a 4x4 world matrix for the decal projector (identity stub).
#[allow(dead_code)]
pub fn decal_world_matrix(d: &DecalExport) -> [[f32; 4]; 4] {
    let _ = d;
    [
        [1.0, 0.0, 0.0, 0.0],
        [0.0, 1.0, 0.0, 0.0],
        [0.0, 0.0, 1.0, 0.0],
        [0.0, 0.0, 0.0, 1.0],
    ]
}

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

    #[test]
    fn default_decal_name() {
        let d = default_decal_export("wound");
        assert_eq!(d.name, "wound");
    }

    #[test]
    fn default_opacity_one() {
        let d = default_decal_export("x");
        assert!((d.opacity - 1.0).abs() < 1e-6);
    }

    #[test]
    fn default_depth_half() {
        let d = default_decal_export("x");
        assert!((d.depth - 0.5).abs() < 1e-6);
    }

    #[test]
    fn default_normal_is_up() {
        let d = default_decal_export("x");
        assert!((d.normal[1] - 1.0).abs() < 1e-6);
    }

    #[test]
    fn json_contains_name() {
        let d = default_decal_export("tattoo");
        let json = export_decal_to_json(&d);
        assert!(json.contains("tattoo"));
    }

    #[test]
    fn json_contains_texture() {
        let d = default_decal_export("x");
        let json = export_decal_to_json(&d);
        assert!(json.contains("texture"));
    }

    #[test]
    fn world_matrix_is_4x4() {
        let d = default_decal_export("x");
        let m = decal_world_matrix(&d);
        assert_eq!(m.len(), 4);
        assert_eq!(m[0].len(), 4);
    }

    #[test]
    fn world_matrix_diagonal_one() {
        let d = default_decal_export("x");
        let m = decal_world_matrix(&d);
        for (i, row) in m.iter().enumerate() {
            assert!((row[i] - 1.0).abs() < 1e-9);
        }
    }

    #[test]
    fn json_valid_brackets() {
        let d = default_decal_export("scar");
        let json = export_decal_to_json(&d);
        assert!(json.starts_with('{'));
        assert!(json.ends_with('}'));
    }

    #[test]
    fn default_size_one_by_one() {
        let d = default_decal_export("x");
        assert!((d.size[0] - 1.0).abs() < 1e-6);
        assert!((d.size[1] - 1.0).abs() < 1e-6);
    }
}