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
// Generated from camera_mod.rs.tera template. Edit the template, not the generated file.
//! View and projection transform helpers.
//!
//! This module provides view matrix (`look_at`, `look_to`) and projection matrix (`perspective`,
//! `orthographic`, `frustum`) constructors.
//!
//! ## Choosing a sub-module
//!
//! Pick [`lh`] or [`rh`] modules based on your world space coordinate system.
//!
//! The view functions in each sub-module transform world space points into Y-up view space while
//! preserving your world's handedness.
//!
//! Note that while the view space methods will preserve the handedness of your world's coordinate
//! systems, view space is a different coordinate system and will not necessarily be the same as
//! your world coordinate system, especially if your world up is not +Y.
//!
//! There are other possible view space coordinate systems, notably Y-down; however, glam only
//! provides view and projection functions for left- and right-handed view space coordinate systems.
//!
//! The corresponding projection functions expect Y-up view space input with the matching
//! handedness.
//!
//! Within each `proj` sub-module, pick the API-specific constructor:
//!
//! | Module | NDC Z | NDC Y |
//! |------------|---------|-------|
//! | `opengl` | [-1, 1] | Up |
//! | `directx` | [0, 1] | Up |
//! | `vulkan` | [0, 1] | Down |
/// View functions produce right-handed Y-up view space with
/// X-right and the negative Z axis pointing forward.
///
/// Projection functions expect right-handed Y-up view space input.
/// View functions produce left-handed Y-up view space with
/// X-right and the positive Z axis pointing forward.
///
/// Projection functions expect left-handed Y-up view space input.