Struct FirstPersonCameraController 

pub struct FirstPersonCameraController {
    pub yaw: f32,
    pub pitch: f32,
    pub sensitivity: f32,
    pub pitch_clamp: f32,
}

Body-attached first-person camera controller.

Call apply once per frame with the resolved ActionFrame and the world-space eye position. The host owns the Camera; this controller writes its center / distance / orientation each frame. Read forward_dir / right_dir to drive character movement.

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.

sensitivity: f32

Look sensitivity, in radians per unit of navigation.orbit delta.

pitch_clamp: f32

Maximum absolute pitch in radians before clamping (e.g. 1.4 is roughly 80 degrees).

Implementations

impl FirstPersonCameraController

pub const DEFAULT_SENSITIVITY: f32 = 0.005

Default look sensitivity applied to the resolved orbit delta.

pub const DEFAULT_PITCH_CLAMP: f32 = 1.4

Default pitch clamp, roughly 80 degrees.

pub fn new(sensitivity: f32, pitch_clamp: f32) -> Self

Create a controller with the given sensitivity and pitch clamp, looking along +Y.

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

Apply the frame’s look delta, then attach the camera eye to eye_position.

eye_position is the world-space eye point, typically the player body origin offset by eye height.

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

Adopt the current view of camera as this controller’s yaw / pitch, so switching into first-person continues from the existing view instead of snapping. Call this when entering first-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. At yaw 0: +Y; at yaw PI/2: +X.

pub fn right_dir(&self) -> Vec3

Horizontal right vector perpendicular to forward_dir, for strafing.

pub fn aim_dir(&self) -> Vec3

Full look direction including pitch, for raycasts and aim.