optic-render 0.0.3

OpenGL 4.6 renderer for Optic engine — EGL context, shaders, meshes, textures, cameras, canvas
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

use optic_core::{CamProj, ClipDist, Size2D};
use cgmath::*;

/// Camera transform state with pre-computed view and projection matrices.
///
/// Holds position, Euler rotation, FOV, clip distances, viewport size, and
/// projection type. Call [`calc_matrices`](CamTransform::calc_matrices) to
/// recompute the view, perspective, and orthographic matrices after mutating
/// any field.
#[derive(Clone, Debug)]
pub struct CamTransform {
    pub pos: Vector3<f32>,
    pub rot: Vector3<f32>,
    pub fov: f32,
    pub clip: ClipDist,
    pub size: Size2D,
    pub proj: CamProj,
    pub view_matrix: Matrix4<f32>,
    pub ortho_scale: f32,
    pub front: Vector3<f32>,
    pub persp_matrix: Matrix4<f32>,
    pub ortho_matrix: Matrix4<f32>,
}

impl CamTransform {
    /// Recalculates view, perspective, and orthographic matrices.
    ///
    /// Also updates the `front` direction vector used for fly-through movement.
    pub fn calc_matrices(&mut self) {
        let aspect = self.size.aspect_ratio();

        // View matrix
        let pitch = Rad::from(Deg(self.rot.x));
        let yaw = Rad::from(Deg(self.rot.y));
        self.front = vec3(
            yaw.cos() * pitch.cos(),
            pitch.sin(),
            yaw.sin() * pitch.cos(),
        )
        .normalize();

        let target = self.pos + self.front;
        let view = Matrix4::<f32>::look_at_rh(Point3::from_vec(self.pos), Point3::from_vec(target), Vector3::unit_y());
        self.view_matrix = view;

        // Projection matrices
        self.persp_matrix = perspective(Rad::from(Deg(self.fov)), aspect, self.clip.near, self.clip.far);
        self.ortho_matrix = ortho(
            -self.ortho_scale * aspect,
            self.ortho_scale * aspect,
            -self.ortho_scale,
            self.ortho_scale,
            self.clip.near,
            self.clip.far,
        );
    }

    /// Returns the view matrix (world-to-camera).
    pub fn view_matrix(&self) -> Matrix4<f32> {
        self.view_matrix
    }

    /// Returns the active projection matrix based on [`proj`](CamTransform::proj).
    pub fn proj_matrix(&self) -> Matrix4<f32> {
        match self.proj {
            CamProj::Persp => self.persp_matrix,
            CamProj::Ortho => self.ortho_matrix,
        }
    }
}