oxihuman-viewer 0.2.1

wgpu/WebGPU rendering adapter for OxiHuman
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

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

#[derive(Debug, Clone)]
pub struct TangentFrameView {
    pub scale: f32,
    pub show_tangent: bool,
    pub show_bitangent: bool,
    pub show_normal: bool,
    pub enabled: bool,
}

pub fn new_tangent_frame_view() -> TangentFrameView {
    TangentFrameView {
        scale: 0.1,
        show_tangent: true,
        show_bitangent: true,
        show_normal: true,
        enabled: false,
    }
}

pub fn tfv_set_scale(v: &mut TangentFrameView, s: f32) {
    v.scale = s.clamp(0.001, 10.0);
}

pub fn tfv_enable(v: &mut TangentFrameView) {
    v.enabled = true;
}

pub fn tfv_toggle_tangent(v: &mut TangentFrameView) {
    v.show_tangent = !v.show_tangent;
}

pub fn tfv_toggle_normal(v: &mut TangentFrameView) {
    v.show_normal = !v.show_normal;
}

pub fn tfv_active_channel_count(v: &TangentFrameView) -> u32 {
    let mut n = 0u32;
    if v.show_tangent {
        n += 1;
    }
    if v.show_bitangent {
        n += 1;
    }
    if v.show_normal {
        n += 1;
    }
    n
}

pub fn tfv_to_json(v: &TangentFrameView) -> String {
    format!(
        r#"{{"scale":{:.4},"show_tangent":{},"show_bitangent":{},"show_normal":{},"enabled":{}}}"#,
        v.scale, v.show_tangent, v.show_bitangent, v.show_normal, v.enabled
    )
}

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

    #[test]
    fn test_new_defaults() {
        /* new view has all channels active */
        let v = new_tangent_frame_view();
        assert_eq!(tfv_active_channel_count(&v), 3);
        assert!(!v.enabled);
    }

    #[test]
    fn test_set_scale() {
        /* valid scale stored */
        let mut v = new_tangent_frame_view();
        tfv_set_scale(&mut v, 0.5);
        assert!((v.scale - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_set_scale_clamp_low() {
        /* below minimum clamped */
        let mut v = new_tangent_frame_view();
        tfv_set_scale(&mut v, -1.0);
        assert!(v.scale >= 0.001);
    }

    #[test]
    fn test_set_scale_clamp_high() {
        /* above maximum clamped */
        let mut v = new_tangent_frame_view();
        tfv_set_scale(&mut v, 100.0);
        assert!(v.scale <= 10.0);
    }

    #[test]
    fn test_enable() {
        /* enable sets flag */
        let mut v = new_tangent_frame_view();
        tfv_enable(&mut v);
        assert!(v.enabled);
    }

    #[test]
    fn test_toggle_tangent() {
        /* toggle changes state */
        let mut v = new_tangent_frame_view();
        let initial = v.show_tangent;
        tfv_toggle_tangent(&mut v);
        assert_ne!(v.show_tangent, initial);
    }

    #[test]
    fn test_toggle_normal() {
        /* toggle changes state */
        let mut v = new_tangent_frame_view();
        let initial = v.show_normal;
        tfv_toggle_normal(&mut v);
        assert_ne!(v.show_normal, initial);
    }

    #[test]
    fn test_active_channel_count_after_toggle() {
        /* disabling tangent reduces count by 1 */
        let mut v = new_tangent_frame_view();
        tfv_toggle_tangent(&mut v);
        assert_eq!(tfv_active_channel_count(&v), 2);
    }

    #[test]
    fn test_to_json() {
        /* JSON has scale key */
        let v = new_tangent_frame_view();
        assert!(tfv_to_json(&v).contains("scale"));
    }
}