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

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

#[derive(Debug, Clone)]
pub struct UvStretchView {
    pub low_threshold: f32,
    pub high_threshold: f32,
    pub enabled: bool,
    pub mode: u32,
}

pub fn new_uv_stretch_view() -> UvStretchView {
    UvStretchView {
        low_threshold: 0.2,
        high_threshold: 0.8,
        enabled: false,
        mode: 0,
    }
}

pub fn usv_set_thresholds(v: &mut UvStretchView, low: f32, high: f32) {
    v.low_threshold = low.clamp(0.0, 1.0);
    v.high_threshold = high.clamp(0.0, 1.0).max(v.low_threshold);
}

pub fn usv_enable(v: &mut UvStretchView) {
    v.enabled = true;
}

pub fn usv_stretch_color(v: &UvStretchView, stretch: f32) -> [f32; 3] {
    if stretch < v.low_threshold {
        [0.0, 0.0, 1.0] /* blue: understretched */
    } else if stretch > v.high_threshold {
        [1.0, 0.0, 0.0] /* red: overstretched */
    } else {
        [0.0, 1.0, 0.0] /* green: good */
    }
}

pub fn usv_mode_name(v: &UvStretchView) -> &str {
    match v.mode {
        0 => "Area",
        1 => "Angle",
        2 => "Length",
        _ => "Unknown",
    }
}

pub fn usv_is_enabled(v: &UvStretchView) -> bool {
    v.enabled
}

pub fn usv_to_json(v: &UvStretchView) -> String {
    format!(
        r#"{{"low_threshold":{:.4},"high_threshold":{:.4},"enabled":{},"mode":{}}}"#,
        v.low_threshold, v.high_threshold, v.enabled, v.mode
    )
}

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

    #[test]
    fn test_new_defaults() {
        /* default thresholds and mode */
        let v = new_uv_stretch_view();
        assert!(v.low_threshold < v.high_threshold);
        assert_eq!(v.mode, 0);
    }

    #[test]
    fn test_set_thresholds() {
        /* stored correctly */
        let mut v = new_uv_stretch_view();
        usv_set_thresholds(&mut v, 0.1, 0.9);
        assert!((v.low_threshold - 0.1).abs() < 1e-6);
        assert!((v.high_threshold - 0.9).abs() < 1e-6);
    }

    #[test]
    fn test_enable() {
        /* enable sets flag */
        let mut v = new_uv_stretch_view();
        usv_enable(&mut v);
        assert!(usv_is_enabled(&v));
    }

    #[test]
    fn test_stretch_color_low() {
        /* under low => blue */
        let v = new_uv_stretch_view();
        let c = usv_stretch_color(&v, 0.0);
        assert_eq!(c, [0.0, 0.0, 1.0]);
    }

    #[test]
    fn test_stretch_color_high() {
        /* over high => red */
        let v = new_uv_stretch_view();
        let c = usv_stretch_color(&v, 1.0);
        assert_eq!(c, [1.0, 0.0, 0.0]);
    }

    #[test]
    fn test_stretch_color_mid() {
        /* in range => green */
        let v = new_uv_stretch_view();
        let c = usv_stretch_color(&v, 0.5);
        assert_eq!(c, [0.0, 1.0, 0.0]);
    }

    #[test]
    fn test_mode_name_area() {
        /* mode 0 = Area */
        let v = new_uv_stretch_view();
        assert_eq!(usv_mode_name(&v), "Area");
    }

    #[test]
    fn test_mode_name_angle() {
        /* mode 1 = Angle */
        let mut v = new_uv_stretch_view();
        v.mode = 1;
        assert_eq!(usv_mode_name(&v), "Angle");
    }

    #[test]
    fn test_to_json() {
        /* JSON has mode field */
        let v = new_uv_stretch_view();
        assert!(usv_to_json(&v).contains("mode"));
    }
}