pub struct FirstPersonController {
pub body: Body3D,
pub previous: Vec3,
/* private fields */
}Expand description
Allocation-free optional helper. Spawn outside static solids; initial overlaps are not depenetrated. Body movement resolves X, Z then Y, using Body3D sweeps.
Fields§
§body: Body3DGame-accessible swept body. External edits must retain Body3D invariants.
previous: Vec3Previous center for interpolation. Use teleport for discontinuous movement.
Implementations§
Source§impl FirstPersonController
impl FirstPersonController
Sourcepub fn new(
position: Vec3,
size: Vec3,
config: FirstPersonConfig,
) -> Result<Self, FirstPersonError>
pub fn new( position: Vec3, size: Vec3, config: FirstPersonConfig, ) -> Result<Self, FirstPersonError>
Creates a controller from center/full body dimensions. Rejects invalid config and nonfinite/nonpositive body dimensions before constructing it.
Sourcepub fn config(&self) -> &FirstPersonConfig
pub fn config(&self) -> &FirstPersonConfig
Current validated configuration.
Sourcepub fn set_config(
&mut self,
config: FirstPersonConfig,
) -> Result<(), FirstPersonError>
pub fn set_config( &mut self, config: FirstPersonConfig, ) -> Result<(), FirstPersonError>
Reconfigures atomically, clamping pitch and clearing pending jump/grace state.
Sourcepub fn yaw(&self) -> f32
pub fn yaw(&self) -> f32
Horizontal yaw in radians, positive turns toward +X from the -Z heading.
Sourcepub fn set_look(&mut self, yaw: f32, pitch: f32) -> Result<(), FirstPersonError>
pub fn set_look(&mut self, yaw: f32, pitch: f32) -> Result<(), FirstPersonError>
Sets finite angles, wrapping yaw and clamping pitch. Failure changes nothing.
Sourcepub fn teleport(&mut self, position: Vec3) -> Result<(), FirstPersonError>
pub fn teleport(&mut self, position: Vec3) -> Result<(), FirstPersonError>
Resets movement, contact, interpolation and pending jumps at a game-chosen position. Keeps look angles; checkpoint/spawn validity remains game policy.
Sourcepub fn step(&mut self, input: FirstPersonInput, dt: f32, solids: &[Aabb3])
pub fn step(&mut self, input: FirstPersonInput, dt: f32, solids: &[Aabb3])
Applies one fixed tick. Panics for invalid input or nonfinite/negative dt. A zero dt applies look only, retaining movement/contact/interpolation state. Consume press edges and relative motion once afterward, including catch-up.