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

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

#[derive(Debug, Clone)]
pub struct BoundaryView {
    pub enabled: bool,
    pub color: [f32; 3],
    pub pulse: bool,
}

pub fn new_boundary_view() -> BoundaryView {
    BoundaryView {
        enabled: false,
        color: [1.0, 0.8, 0.0],
        pulse: false,
    }
}

pub fn bov_set_color(v: &mut BoundaryView, r: f32, g: f32, b: f32) {
    v.color = [r.clamp(0.0, 1.0), g.clamp(0.0, 1.0), b.clamp(0.0, 1.0)];
}

pub fn bov_enable(v: &mut BoundaryView) {
    v.enabled = true;
}

pub fn bov_toggle_pulse(v: &mut BoundaryView) {
    v.pulse = !v.pulse;
}

pub fn bov_boundary_color(v: &BoundaryView, time: f32) -> [f32; 3] {
    if v.pulse {
        let alpha = (time * std::f32::consts::TAU).sin() * 0.5 + 0.5;
        [v.color[0] * alpha, v.color[1] * alpha, v.color[2] * alpha]
    } else {
        v.color
    }
}

pub fn bov_is_enabled(v: &BoundaryView) -> bool {
    v.enabled
}

pub fn bov_to_json(v: &BoundaryView) -> String {
    format!(
        r#"{{"enabled":{},"color":[{:.4},{:.4},{:.4}],"pulse":{}}}"#,
        v.enabled, v.color[0], v.color[1], v.color[2], v.pulse
    )
}

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

    #[test]
    fn test_new_defaults() {
        /* disabled, yellow, no pulse */
        let v = new_boundary_view();
        assert!(!v.enabled);
        assert!(!v.pulse);
        assert!((v.color[0] - 1.0).abs() < 1e-6);
    }

    #[test]
    fn test_set_color() {
        /* color stored */
        let mut v = new_boundary_view();
        bov_set_color(&mut v, 0.5, 0.6, 0.7);
        assert!((v.color[0] - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_set_color_clamp() {
        /* clamp to [0,1] */
        let mut v = new_boundary_view();
        bov_set_color(&mut v, 5.0, -1.0, 0.5);
        assert_eq!(v.color[0], 1.0);
        assert_eq!(v.color[1], 0.0);
    }

    #[test]
    fn test_enable() {
        /* enable sets flag */
        let mut v = new_boundary_view();
        bov_enable(&mut v);
        assert!(bov_is_enabled(&v));
    }

    #[test]
    fn test_toggle_pulse() {
        /* toggle flips flag */
        let mut v = new_boundary_view();
        bov_toggle_pulse(&mut v);
        assert!(v.pulse);
        bov_toggle_pulse(&mut v);
        assert!(!v.pulse);
    }

    #[test]
    fn test_boundary_color_no_pulse() {
        /* without pulse returns stored color */
        let v = new_boundary_view();
        let c = bov_boundary_color(&v, 0.5);
        assert_eq!(c, v.color);
    }

    #[test]
    fn test_boundary_color_pulse_range() {
        /* with pulse, channels in [0,1] */
        let mut v = new_boundary_view();
        bov_toggle_pulse(&mut v);
        let c = bov_boundary_color(&v, 0.25);
        for ch in c {
            assert!((0.0..=1.0).contains(&ch));
        }
    }

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

    #[test]
    fn test_clone() {
        /* clone is independent */
        let v = new_boundary_view();
        let v2 = v.clone();
        assert_eq!(v.color, v2.color);
    }
}