Struct Camera 

pub struct Camera {
    pub view: Mat4,
    pub focal_length: f32,
}

A pinhole camera that shows a 3D scene in a composable’s bounds.

The camera looks along its own z axis with its x to the right and y down. A point at (x, y, z) in the camera’s frame shows at center + (x, y) * focal_length / z, where center is the middle of the bounds.

Fields

view: Mat4

Maps scene space into the camera’s frame.

focal_length: f32

The distance from the eye to the image, in logical pixels: the distance at which one scene unit shows as one pixel.

Implementations

impl Camera

pub fn look_at(eye: Vec3, target: Vec3, down: Vec3, focal_length: f32) -> Camera

A camera at eye that looks at target. down is the scene direction that shows as down; it need not be square to the view.

pub fn focal_length_for(height: f32, vertical_fov: f32) -> f32

The focal length that shows vertical_fov radians across height pixels.

pub fn eye(&self) -> Vec3

The eye’s position in scene space.

pub fn near(&self) -> f32

The camera-frame depth below which the camera sees nothing.

pub fn project(&self, point: Vec3, size: Size) -> Option<Point>

Where point shows in bounds of size; None when it lies nearer than Self::near or behind the eye.

pub fn doorway(&self, window: Rect) -> Mat4

The map from the scene this camera sees into the frame in which window, a rect on the frame’s plane, is a doorway into the scene: the camera stands in the doorway’s middle, looking along the frame’s z, with its x and y along the frame’s, a scene unit to a frame unit. What the camera sees lies behind the doorway.

pub fn ray(&self, point: Point, size: Size) -> Option<Ray>

The ray from the eye through point of bounds of size, in scene space, with a direction that reaches depth one in the camera’s frame at distance one.

Trait Implementations

impl Clone for Camera

fn clone(&self) -> Camera

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Camera

impl Debug for Camera

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

Formats the value using the given formatter.

impl PartialEq for Camera

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Camera