Struct three_d::CameraControl

pub struct CameraControl { /* fields omitted */ }

3D controls for a camera. Use this to add additional control functionality to a camera.

Implementations

impl CameraControl

pub fn new(camera: Camera) -> Self

pub fn translate(&mut self, change: &Vec3) -> Result<(), Error>

pub fn rotate(&mut self, x: f32, y: f32) -> Result<(), Error>

pub fn rotate_around_up(&mut self, x: f32, y: f32) -> Result<(), Error>

pub fn pan(&mut self, x: f32, y: f32) -> Result<(), Error>

pub fn zoom(&mut self, wheel: f32) -> Result<(), Error>

Methods from Deref<Target = Camera>

pub fn set_perspective_projection(
    &mut self,
    field_of_view_y: Degrees,
    aspect: f32,
    z_near: f32,
    z_far: f32
) -> Result<(), Error>

Specify the camera to use perspective projection with the given field of view in the y-direction, aspect and near and far plane.

pub fn set_orthographic_projection(
    &mut self,
    width: f32,
    height: f32,
    depth: f32
) -> Result<(), Error>

Specify the camera to use orthographic projection with the given width, height and depth. The view frustum width is +/- width/2, height is +/- height/2 and depth is 0 to depth.

pub fn set_aspect(&mut self, value: f32) -> Result<bool, Error>

Change the current projection to abide to the given aspect ratio.

pub fn set_view(
    &mut self,
    position: Vec3,
    target: Vec3,
    up: Vec3
) -> Result<(), Error>

Change the view of the camera. The camera is placed at the given position, looking at the given target and with the given up direction.

pub fn mirror_in_xz_plane(&mut self) -> Result<(), Error>

pub fn in_frustum(&self, aabb: &AxisAlignedBoundingBox) -> bool

Returns whether or not the given bounding box is within the camera frustum. It returns false if it is fully outside and true if it is inside or intersects.

pub fn view_direction_at(&self, screen_coordinates: (f64, f64)) -> Vec3

Returns the view direction at the given screen/image plane coordinates. The coordinates must be between 0 and 1, where (0, 0) indicate the top left corner of the screen and (1, 1) indicate the bottom right corner.

pub fn projection_type(&self) -> &ProjectionType

pub fn view(&self) -> &Mat4

pub fn projection(&self) -> &Mat4

pub fn position(&self) -> &Vec3

pub fn target(&self) -> &Vec3

pub fn up(&self) -> &Vec3

pub fn matrix_buffer(&self) -> &UniformBuffer

Trait Implementations

impl Deref for CameraControl

type Target = Camera

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for CameraControl

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.