Struct Camera3d

pub struct Camera3d { /* private fields */ }

Represents a camera (“view”) positioned and oriented in a 3D scene with a 3D transformation and a 3D projection.

Implementations

impl Camera3d

pub fn new(viewport_width: u16, viewport_height: u16) -> Self

Create a new camera centered at the origin looking down the positive Y axis with ‘up’ vector aligned with the Z axis.

pub fn with_pose( viewport_width: u16, viewport_height: u16, pose: Pose3<f32>, ) -> Self

Create a new 3D camera with the given viewport, position, and 3D pose

pub fn position(&self) -> Point3<f32>

pub fn yaw(&self) -> Rad<f32>

pub fn pitch(&self) -> Rad<f32>

pub fn roll(&self) -> Rad<f32>

pub fn orientation(&self) -> Rotation3<f32>

pub fn transform_mat_world_to_view(&self) -> Matrix4<f32>

pub fn projection(&self) -> &Projection3d

pub fn set_viewport_dimensions( &mut self, viewport_width: u16, viewport_height: u16, )

Should be called when the screen resolution changes.

pub fn set_position(&mut self, position: Point3<f32>)

pub fn set_orientation(&mut self, orientation: Rotation3<f32>)

pub fn scale_fovy_or_zoom(&mut self, scale: f32)

pub fn rotate(&mut self, dyaw: Rad<f32>, dpitch: Rad<f32>, droll: Rad<f32>)

pub fn move_local_xy(&mut self, dx: f32, dy: f32, dz: f32)

Moves the view position relative to the X/Y plane with X and Y direction determined by heading and Z always aligned with the Z axis, i.e. the translated position is only determined by the current yaw not the pitch.

pub fn look_at(&mut self, target: Point3<f32>)

Updates the camera pose to look at the given point.

If the target point is equal to the camera position, then the identity orientation is used.

pub fn view_mats(&self) -> ([[f32; 4]; 4], [[f32; 4]; 4])

Returns the raw world to view transform and view to clip projection matrix data, suitable for use as shader uniforms.

pub fn to_orthographic(&mut self, zoom: f32)

Modify the projection to orthographic

pub fn to_perspective(&mut self, fovy: Rad<f32>)

Modify the projection to perspective

Trait Implementations

impl Clone for Camera3d

fn clone(&self) -> Camera3d

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Camera3d

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

Formats the value using the given formatter.

impl PartialEq for Camera3d

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Camera3d