Struct Camera 

pub struct Camera {

    pub position: Vec3,
    pub target: Vec3,
    pub up: Vec3,
    pub fov: f32,
    pub aspect_ratio: f32,
    pub near: f32,
    pub far: f32,
    pub navigation_style: NavigationStyle,
    pub projection_mode: ProjectionMode,
    pub up_direction: AxisDirection,
    pub front_direction: AxisDirection,
    pub move_speed: f32,
    pub ortho_scale: f32,
    pub flight: Option<CameraFlight>,
}

A 3D camera for viewing the scene.

Fields

position: Vec3

Camera position in world space.

target: Vec3

Point the camera is looking at.

up: Vec3

Up vector.

fov: f32

Field of view in radians.

aspect_ratio: f32

Aspect ratio (width / height).

near: f32

Near clipping plane.

far: f32

Far clipping plane.

navigation_style: NavigationStyle

Navigation style.

projection_mode: ProjectionMode

Projection mode.

up_direction: AxisDirection

Up direction.

front_direction: AxisDirection

Front direction.

move_speed: f32

Movement speed multiplier.

ortho_scale: f32

Orthographic scale (used when projection_mode is Orthographic).

flight: Option<CameraFlight>

Active camera flight animation (if any).

Implementations

impl Camera

pub fn new(aspect_ratio: f32) -> Self

Creates a new camera with default settings.

pub fn set_aspect_ratio(&mut self, aspect_ratio: f32)

Sets the aspect ratio.

pub fn view_matrix(&self) -> Mat4

Returns the view matrix.

pub fn projection_matrix(&self) -> Mat4

Returns the projection matrix.

pub fn view_projection_matrix(&self) -> Mat4

Returns the combined view-projection matrix.

pub fn forward(&self) -> Vec3

Returns the camera’s forward direction.

pub fn right(&self) -> Vec3

Returns the camera’s right direction.

pub fn camera_up(&self) -> Vec3

Returns the camera’s local up direction (from the view matrix).

pub fn orbit_turntable(&mut self, delta_x: f32, delta_y: f32)

Turntable orbit: yaw around world-space up, pitch around camera-space right, with gimbal-lock protection. Always looks at target.

Matches C++ Polyscope processRotate for NavigateStyle::Turntable: operates on the view matrix directly, then reconstructs position via lookAt. This avoids degenerate cross products at the poles that occur when transforming the camera position in world space.

pub fn orbit_free(&mut self, delta_x: f32, delta_y: f32)

Free orbit: unconstrained rotation using camera-local axes. Both yaw and pitch use the camera’s own coordinate frame.

Matches C++ Polyscope processRotate for NavigateStyle::Free.

pub fn orbit_arcball(&mut self, start: [f32; 2], end: [f32; 2])

Arcball orbit: maps 2D mouse positions to a virtual sphere for rotation. start and end are normalized screen coordinates in [-1, 1].

Matches C++ Polyscope processRotate for NavigateStyle::Arcball.

pub fn mouse_look(&mut self, delta_x: f32, delta_y: f32)

First-person mouse look: yaw around world up, pitch around camera right. Unlike orbit modes, this moves the target (look direction) rather than orbiting around a fixed target.

Matches C++ Polyscope processRotate for NavigateStyle::FirstPerson.

pub fn move_first_person(&mut self, delta: Vec3)

First-person WASD movement in camera-local coordinates. delta is (right, up, forward) movement in camera space, pre-scaled by move_speed and delta time by the caller.

pub fn orbit(&mut self, delta_x: f32, delta_y: f32)

Legacy orbit method — delegates to orbit_turntable.

pub fn pan(&mut self, delta_x: f32, delta_y: f32)

Pans the camera (translates position and target together). For Turntable mode, this moves the orbit center.

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

Zooms the camera (moves toward/away from target for perspective, adjusts ortho_scale for orthographic).

pub fn look_at_box(&mut self, min: Vec3, max: Vec3)

Resets the camera to look at the given bounding box.

pub fn set_navigation_style(&mut self, style: NavigationStyle)

Sets the navigation style.

pub fn set_projection_mode(&mut self, mode: ProjectionMode)

Sets the projection mode.

pub fn set_up_direction(&mut self, direction: AxisDirection)

Sets the up direction and updates both the up vector and front direction. The front direction is automatically derived using right-hand coordinate conventions.

pub fn set_move_speed(&mut self, speed: f32)

Sets the movement speed.

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

Sets the orthographic scale.

pub fn set_fov(&mut self, fov: f32)

Sets the field of view in radians.

pub fn set_near(&mut self, near: f32)

Sets the near clipping plane.

pub fn set_far(&mut self, far: f32)

Sets the far clipping plane.

pub fn start_flight_to( &mut self, target_view: Mat4, target_fov: f32, duration_secs: f32, )

Starts a smooth animated flight to the given view matrix and FOV.

The target_view is a 4x4 view matrix (world-to-eye). The target_fov is in radians. duration_secs controls the flight length (C++ Polyscope default is 0.4 seconds).

pub fn update_flight(&mut self)

Updates the camera flight animation. Call once per frame.

When the flight completes, the camera is set exactly to the target position and self.flight is cleared.

pub fn cancel_flight(&mut self)

Cancels any active camera flight animation.

pub fn is_in_flight(&self) -> bool

Returns whether a camera flight animation is currently active.

pub fn fov_degrees(&self) -> f32

Returns FOV in degrees.

pub fn set_fov_degrees(&mut self, degrees: f32)

Sets FOV from degrees.

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 Debug for Camera

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

Formats the value using the given formatter.

impl Default for Camera

fn default() -> Self

Returns the “default value” for a type.