Struct ThirdPersonCameraController 

pub struct ThirdPersonCameraController {
    pub yaw: f32,
    pub pitch: f32,
    pub yaw_sensitivity: f32,
    pub pitch_sensitivity: f32,
    pub pitch_clamp: (f32, f32),
    pub distance: f32,
    pub height: f32,
    pub shoulder_offset: Vec2,
}

Body-attached third-person orbit-and-boom camera controller.

Call apply once per frame with the resolved ActionFrame and the world-space target position. The host owns the Camera; this controller writes its center / distance / orientation each frame.

Fields

yaw: f32

Horizontal look angle in radians (rotation around world Z).

pitch: f32

Vertical look angle in radians above the horizontal plane: positive looks up.

yaw_sensitivity: f32

Horizontal look sensitivity, in radians per unit of navigation.orbit.x.

pitch_sensitivity: f32

Vertical look sensitivity, in radians per unit of navigation.orbit.y.

pitch_clamp: (f32, f32)

(min, max) allowed pitch in radians. Defaults to roughly (-PI/4, +PI/4) so the camera neither dives into the ground nor flips overhead.

distance: f32

Distance from the orbit pivot to the camera eye. Larger values pull the eye further back behind the target.

height: f32

Height offset above the target used as the orbit pivot (roughly chest height for a character).

shoulder_offset: Vec2

(right, up) offset of the orbit pivot for over-the-shoulder framing. Vec2::ZERO is centred.

Implementations

impl ThirdPersonCameraController

pub const DEFAULT_DISTANCE: f32 = 6.0

Default boom distance.

pub const DEFAULT_HEIGHT: f32 = 1.2

Default pivot height above the target.

pub fn new(yaw_sensitivity: f32, pitch_sensitivity: f32) -> Self

Create a controller with the given look sensitivities and third-person defaults (distance = 6.0, height = 1.2, pitch clamped to +/- PI/4).

pub fn with_distance(self, distance: f32) -> Self

Builder: set the boom distance.

pub fn with_height(self, height: f32) -> Self

Builder: set the pivot height above the target.

pub fn with_shoulder_offset(self, offset: Vec2) -> Self

Builder: set the (right, up) shoulder offset.

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

Builder: set the (min, max) pitch clamp in radians.

pub fn apply(&mut self, camera: &mut Camera, frame: &ActionFrame, target: Vec3)

Apply the frame’s look delta, then orbit the camera around target.

The orbit pivot lands height above the target, shifted by shoulder_offset in the camera-local right / up axes.

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

Adopt the current view of camera as this controller’s yaw / pitch, so switching into third-person continues from the existing view instead of snapping. Call this when entering third-person mode.

pub fn set_look(&mut self, yaw: f32, pitch: f32)

Jump to an explicit look direction. pitch is clamped.

pub fn forward_dir(&self) -> Vec3

Horizontal forward vector (yaw only, z = 0) for movement.

pub fn right_dir(&self) -> Vec3

Horizontal right vector, for strafing and the shoulder offset.

pub fn aim_dir(&self) -> Vec3

Full look direction including pitch.