Struct View 

#[non_exhaustive]
pub struct View {
    pub frame: Frame3,
    pub near: Option<f64>,
    pub far: Option<f64>,
    pub projection: ViewProjection,
}

A view: orthographic by default, or perspective (see ViewProjection).

For a model point p the view coordinates are ((p - o)·x, (p - o)·y) and the depth W = (p - o)·z, where o, x, y, z are the frame’s origin and axes. The viewer sits on the +z side and looks along -z, so a larger W is nearer. An orthographic view’s image is the view coordinates; a perspective view’s is described at ViewProjection::Perspective. Geometry is kept where far <= W <= near (both closed); an absent bound is no bound, except that a perspective view has a near below zero.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

frame: Frame3

Right-handed orthonormal view frame.

near: Option<f64>

Nearest kept depth.

far: Option<f64>

Farthest kept depth.

projection: ViewProjection

How points are projected to the image.

Implementations

impl View

pub const fn new(frame: Frame3) -> Self

An orthographic view without depth clipping.

pub fn perspective(frame: Frame3, near: f64) -> Result<Self, HiddenLineError>

A perspective view from the eye at frame.origin, keeping depths W <= near. near must be finite and below zero; anything else is refused, since the central projection is undefined at and behind the eye.

pub const fn with_near(self, near: f64) -> Self

Keep only depths W <= near.

pub const fn with_far(self, far: f64) -> Self

Keep only depths W >= far.

Trait Implementations

impl Clone for View

fn clone(&self) -> View

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for View

impl Debug for View

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

Formats the value using the given formatter.

impl PartialEq for View

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for View