nightshade 0.13.0

A cross-platform data-oriented game engine.
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

use nalgebra_glm::Mat4;

/// Orthographic projection settings following glTF conventions.
///
/// Creates a parallel projection where objects appear the same size
/// regardless of distance. Uses reverse-Z depth buffer.
#[derive(Debug, Clone, Copy, PartialEq, serde::Serialize, serde::Deserialize)]
pub struct OrthographicCamera {
    /// Half-width of the view volume (horizontal extent is ±x_mag).
    pub x_mag: f32,
    /// Half-height of the view volume (vertical extent is ±y_mag).
    pub y_mag: f32,
    /// Far clipping plane distance.
    pub z_far: f32,
    /// Near clipping plane distance.
    pub z_near: f32,
}

impl Default for OrthographicCamera {
    fn default() -> Self {
        Self {
            x_mag: 10.0,
            y_mag: 10.0,
            z_far: 1000.0,
            z_near: 0.01,
        }
    }
}

impl OrthographicCamera {
    /// Returns the orthographic projection matrix.
    pub fn matrix(&self) -> Mat4 {
        reverse_z_ortho(
            -self.x_mag,
            self.x_mag,
            -self.y_mag,
            self.y_mag,
            self.z_near,
            self.z_far,
        )
    }
}

fn reverse_z_ortho(left: f32, right: f32, bottom: f32, top: f32, near: f32, far: f32) -> Mat4 {
    let width = right - left;
    let height = top - bottom;
    let depth = far - near;

    Mat4::new(
        2.0 / width,
        0.0,
        0.0,
        -(right + left) / width,
        0.0,
        2.0 / height,
        0.0,
        -(top + bottom) / height,
        0.0,
        0.0,
        1.0 / depth,
        far / depth,
        0.0,
        0.0,
        0.0,
        1.0,
    )
}