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
138
139

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

//! Level set isosurface view — shows the zero-level surface of a scalar field.

/// Level set view configuration.
#[derive(Debug, Clone)]
pub struct LevelSetView {
    pub enabled: bool,
    pub iso_value: f32,
    pub show_gradient: bool,
    pub surface_opacity: f32,
    pub wireframe: bool,
}

impl LevelSetView {
    pub fn new() -> Self {
        Self {
            enabled: false,
            iso_value: 0.0,
            show_gradient: false,
            surface_opacity: 0.8,
            wireframe: false,
        }
    }
}

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

/// Create a new level set view.
pub fn new_level_set_view() -> LevelSetView {
    LevelSetView::new()
}

/// Enable or disable level set display.
pub fn lsv_set_enabled(v: &mut LevelSetView, enabled: bool) {
    v.enabled = enabled;
}

/// Set the iso-value to extract.
pub fn lsv_set_iso_value(v: &mut LevelSetView, iso: f32) {
    v.iso_value = iso;
}

/// Toggle gradient arrow display.
pub fn lsv_set_show_gradient(v: &mut LevelSetView, show: bool) {
    v.show_gradient = show;
}

/// Set surface opacity.
pub fn lsv_set_surface_opacity(v: &mut LevelSetView, o: f32) {
    v.surface_opacity = o.clamp(0.0, 1.0);
}

/// Toggle wireframe overlay.
pub fn lsv_set_wireframe(v: &mut LevelSetView, wf: bool) {
    v.wireframe = wf;
}

/// Serialize to JSON-like string.
pub fn level_set_view_to_json(v: &LevelSetView) -> String {
    format!(
        r#"{{"enabled":{},"iso_value":{:.4},"show_gradient":{},"surface_opacity":{:.4},"wireframe":{}}}"#,
        v.enabled, v.iso_value, v.show_gradient, v.surface_opacity, v.wireframe
    )
}

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

    #[test]
    fn test_defaults() {
        let v = new_level_set_view();
        assert!(!v.enabled);
        assert_eq!(v.iso_value, 0.0);
    }

    #[test]
    fn test_enable() {
        let mut v = new_level_set_view();
        lsv_set_enabled(&mut v, true);
        assert!(v.enabled);
    }

    #[test]
    fn test_iso_value_set() {
        let mut v = new_level_set_view();
        lsv_set_iso_value(&mut v, 0.5);
        assert!((v.iso_value - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_iso_value_negative() {
        let mut v = new_level_set_view();
        lsv_set_iso_value(&mut v, -1.5);
        assert!((v.iso_value - (-1.5)).abs() < 1e-6);
    }

    #[test]
    fn test_gradient_toggle() {
        let mut v = new_level_set_view();
        lsv_set_show_gradient(&mut v, true);
        assert!(v.show_gradient);
    }

    #[test]
    fn test_opacity_clamp() {
        let mut v = new_level_set_view();
        lsv_set_surface_opacity(&mut v, 3.0);
        assert_eq!(v.surface_opacity, 1.0);
    }

    #[test]
    fn test_wireframe_toggle() {
        let mut v = new_level_set_view();
        lsv_set_wireframe(&mut v, true);
        assert!(v.wireframe);
    }

    #[test]
    fn test_json_keys() {
        let v = new_level_set_view();
        let s = level_set_view_to_json(&v);
        assert!(s.contains("iso_value"));
    }

    #[test]
    fn test_clone() {
        let v = new_level_set_view();
        let v2 = v.clone();
        assert!((v2.surface_opacity - v.surface_opacity).abs() < 1e-6);
    }
}