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
140
141

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

//! Joint pivot point visualization — renders joint axes and pivot markers.

/// Joint pivot view configuration.
#[derive(Debug, Clone)]
pub struct JointPivotView {
    pub enabled: bool,
    pub axis_length: f32,
    pub pivot_radius: f32,
    pub color_x: [f32; 4],
    pub color_y: [f32; 4],
    pub color_z: [f32; 4],
}

impl JointPivotView {
    pub fn new() -> Self {
        Self {
            enabled: false,
            axis_length: 0.1,
            pivot_radius: 0.02,
            color_x: [1.0, 0.0, 0.0, 1.0],
            color_y: [0.0, 1.0, 0.0, 1.0],
            color_z: [0.0, 0.0, 1.0, 1.0],
        }
    }
}

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

/// Create a new joint pivot view.
pub fn new_joint_pivot_view() -> JointPivotView {
    JointPivotView::new()
}

/// Enable or disable the pivot view.
pub fn jpv_set_enabled(v: &mut JointPivotView, enabled: bool) {
    v.enabled = enabled;
}

/// Set axis indicator length.
pub fn jpv_set_axis_length(v: &mut JointPivotView, len: f32) {
    v.axis_length = len.clamp(0.001, 1.0);
}

/// Set pivot sphere radius.
pub fn jpv_set_pivot_radius(v: &mut JointPivotView, r: f32) {
    v.pivot_radius = r.clamp(0.001, 0.5);
}

/// Set X-axis color.
pub fn jpv_set_color_x(v: &mut JointPivotView, color: [f32; 4]) {
    v.color_x = color;
}

/// Set Y-axis color.
pub fn jpv_set_color_y(v: &mut JointPivotView, color: [f32; 4]) {
    v.color_y = color;
}

/// Serialize to JSON-like string.
pub fn joint_pivot_view_to_json(v: &JointPivotView) -> String {
    format!(
        r#"{{"enabled":{},"axis_length":{:.4},"pivot_radius":{:.4}}}"#,
        v.enabled, v.axis_length, v.pivot_radius
    )
}

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

    #[test]
    fn test_defaults() {
        let v = new_joint_pivot_view();
        assert!(!v.enabled);
        assert!((v.axis_length - 0.1).abs() < 1e-6);
    }

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

    #[test]
    fn test_axis_length_clamp_min() {
        let mut v = new_joint_pivot_view();
        jpv_set_axis_length(&mut v, 0.0);
        assert_eq!(v.axis_length, 0.001);
    }

    #[test]
    fn test_axis_length_set() {
        let mut v = new_joint_pivot_view();
        jpv_set_axis_length(&mut v, 0.5);
        assert!((v.axis_length - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_pivot_radius_clamp() {
        let mut v = new_joint_pivot_view();
        jpv_set_pivot_radius(&mut v, 10.0);
        assert_eq!(v.pivot_radius, 0.5);
    }

    #[test]
    fn test_color_x() {
        let mut v = new_joint_pivot_view();
        jpv_set_color_x(&mut v, [0.5, 0.5, 0.5, 1.0]);
        assert!((v.color_x[0] - 0.5).abs() < 1e-6);
    }

    #[test]
    fn test_color_y() {
        let mut v = new_joint_pivot_view();
        jpv_set_color_y(&mut v, [1.0, 1.0, 0.0, 1.0]);
        assert!((v.color_y[1] - 1.0).abs() < 1e-6);
    }

    #[test]
    fn test_json_keys() {
        let v = new_joint_pivot_view();
        let s = joint_pivot_view_to_json(&v);
        assert!(s.contains("axis_length"));
    }

    #[test]
    fn test_clone() {
        let v = new_joint_pivot_view();
        let v2 = v.clone();
        assert_eq!(v2.enabled, v.enabled);
    }
}