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

#![allow(dead_code)]
//! Render viewport: defines a rectangular viewport region.

/// A render viewport.
#[allow(dead_code)]
#[derive(Debug, Clone)]
pub struct RenderViewport {
    x: u32,
    y: u32,
    width: u32,
    height: u32,
}

/// Create a new render viewport.
#[allow(dead_code)]
pub fn new_render_viewport(x: u32, y: u32, width: u32, height: u32) -> RenderViewport {
    RenderViewport { x, y, width, height }
}

/// Return the X origin.
#[allow(dead_code)]
pub fn viewport_x(vp: &RenderViewport) -> u32 {
    vp.x
}

/// Return the Y origin.
#[allow(dead_code)]
pub fn viewport_y(vp: &RenderViewport) -> u32 {
    vp.y
}

/// Return the width.
#[allow(dead_code)]
pub fn viewport_width_rv(vp: &RenderViewport) -> u32 {
    vp.width
}

/// Return the height.
#[allow(dead_code)]
pub fn viewport_height_rv(vp: &RenderViewport) -> u32 {
    vp.height
}

/// Return the aspect ratio (width / height). Returns 1.0 if height is 0.
#[allow(dead_code)]
pub fn viewport_aspect_rv(vp: &RenderViewport) -> f32 {
    if vp.height == 0 {
        return 1.0;
    }
    vp.width as f32 / vp.height as f32
}

/// Serialize to JSON-like string.
#[allow(dead_code)]
pub fn viewport_to_json(vp: &RenderViewport) -> String {
    format!(
        "{{\"x\":{},\"y\":{},\"width\":{},\"height\":{}}}",
        vp.x, vp.y, vp.width, vp.height
    )
}

/// Check if a point (px, py) is within the viewport.
#[allow(dead_code)]
pub fn viewport_contains_point_rv(vp: &RenderViewport, px: u32, py: u32) -> bool {
    (vp.x..=vp.x + vp.width).contains(&px) && (vp.y..=vp.y + vp.height).contains(&py)
}

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

    #[test]
    fn test_new_viewport() {
        let vp = new_render_viewport(0, 0, 800, 600);
        assert_eq!(viewport_width_rv(&vp), 800);
    }

    #[test]
    fn test_x_y() {
        let vp = new_render_viewport(10, 20, 100, 100);
        assert_eq!(viewport_x(&vp), 10);
        assert_eq!(viewport_y(&vp), 20);
    }

    #[test]
    fn test_width_height() {
        let vp = new_render_viewport(0, 0, 1920, 1080);
        assert_eq!(viewport_width_rv(&vp), 1920);
        assert_eq!(viewport_height_rv(&vp), 1080);
    }

    #[test]
    fn test_aspect_ratio() {
        let vp = new_render_viewport(0, 0, 1920, 1080);
        let aspect = viewport_aspect_rv(&vp);
        assert!((aspect - 1920.0 / 1080.0).abs() < 0.01);
    }

    #[test]
    fn test_aspect_zero_height() {
        let vp = new_render_viewport(0, 0, 100, 0);
        assert!((viewport_aspect_rv(&vp) - 1.0).abs() < 1e-6);
    }

    #[test]
    fn test_to_json() {
        let vp = new_render_viewport(0, 0, 800, 600);
        let json = viewport_to_json(&vp);
        assert!(json.contains("\"width\":800"));
    }

    #[test]
    fn test_contains_point_inside() {
        let vp = new_render_viewport(10, 10, 100, 100);
        assert!(viewport_contains_point_rv(&vp, 50, 50));
    }

    #[test]
    fn test_contains_point_outside() {
        let vp = new_render_viewport(10, 10, 100, 100);
        assert!(!viewport_contains_point_rv(&vp, 5, 5));
    }

    #[test]
    fn test_contains_point_boundary() {
        let vp = new_render_viewport(0, 0, 100, 100);
        assert!(viewport_contains_point_rv(&vp, 0, 0));
        assert!(viewport_contains_point_rv(&vp, 100, 100));
    }

    #[test]
    fn test_square_viewport() {
        let vp = new_render_viewport(0, 0, 512, 512);
        assert!((viewport_aspect_rv(&vp) - 1.0).abs() < 1e-6);
    }
}