Struct OrbitCameraController 

pub struct OrbitCameraController {
    pub target: Point3<f32>,
    pub distance: f32,
    pub yaw: f32,
    pub pitch: f32,
    pub min_distance: f32,
    pub max_distance: f32,
    pub min_pitch: f32,
    pub max_pitch: f32,
}

Orbit / Arcball camera controller that orbits around a focal point.

Ideal for model viewers, strategy games, third-person character cameras, and touch-drag / analog-stick rotation on embedded screens.

Fields

target: Point3<f32>

Focal point around which the camera orbits.

distance: f32

Distance from the camera to the target.

yaw: f32

Azimuthal angle (horizontal rotation) in radians.

pitch: f32

Polar angle (vertical rotation) in radians. Clamped to prevent flipping.

min_distance: f32

Minimum allowed distance (zoom limit).

max_distance: f32

Maximum allowed distance.

min_pitch: f32

Minimum pitch angle in radians (default: ~ -89°).

max_pitch: f32

Maximum pitch angle in radians (default: ~ +89°).

Implementations

impl OrbitCameraController

pub fn new(target: Point3<f32>, distance: f32) -> Self

Create a new orbit camera controller looking at target from distance.

pub fn with_distance_limits(self, min: f32, max: f32) -> Self

Builder for customizing zoom distance boundaries.

pub fn with_pitch_limits(self, min: f32, max: f32) -> Self

Builder for customizing pitch clamping limits (in radians).

pub fn orbit(&mut self, delta_yaw: f32, delta_pitch: f32)

Rotate around the target by delta yaw and pitch (in radians).

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

Zoom in (negative delta) or out (positive delta).

pub fn pan(&mut self, delta_right: f32, delta_up: f32)

Pan the focal target in camera-local horizontal and vertical directions.

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

Calculate the camera eye position in world space.

pub fn update_camera(&self, camera: &mut Camera)

Synchronize state to an engine Camera.

Trait Implementations

impl Clone for OrbitCameraController

fn clone(&self) -> OrbitCameraController

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for OrbitCameraController

impl Debug for OrbitCameraController

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

Formats the value using the given formatter.

impl PartialEq for OrbitCameraController

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OrbitCameraController