Enum Projection 

pub enum Projection {
    Perspective {
        fov_y: f32,
        aspect: f32,
        near: f32,
        far: f32,
    },
    Orthographic {
        height: f32,
        aspect: f32,
        near: f32,
        far: f32,
    },
}

How a camera maps view space to clip space.

Orthographic projection is offered as a first-class choice because it is often the physically correct one: parallel lines stay parallel and distances compare across the image.

Variants

Perspective

Perspective projection with a vertical field of view in radians.

Fields

fov_y: f32

Vertical field of view, radians.

aspect: f32

Width over height.

near: f32

Near plane distance, Ångström; maps to clip depth 1.0.

far: f32

Far plane distance, Ångström; maps to clip depth 0.0.

Orthographic

Orthographic projection with an explicit vertical extent.

Fields

height: f32

Full visible height, Ångström.

aspect: f32

Width over height.

near: f32

Near plane distance, Ångström; maps to clip depth 1.0.

far: f32

Far plane distance, Ångström; maps to clip depth 0.0.

Implementations

impl Projection

pub fn matrix(&self) -> Mat4

The clip-from-view matrix with reversed [0, 1] depth.

pub fn fit_near_far(&mut self, eye: Vec3, bound: &BoundingSphere)

Refits the near and far planes to a world-space bounding sphere seen from eye looking toward the sphere. Called on camera change so the depth range always brackets the scene tightly.

pub fn aspect(&self) -> f32

Width over height.

pub fn set_aspect(&mut self, new_aspect: f32)

Updates the aspect ratio, preserving everything else.

Trait Implementations

impl Clone for Projection

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Projection

impl Debug for Projection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Projection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Projection

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Projection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Projection