Struct RigidBody1D

Source

pub struct RigidBody1D {
    pub mass_properties: MassProperties,
    pub position: f64,
    pub velocity: f64,
    pub angle: f64,
    pub angular_velocity: f64,
}

Expand description

A one-dimensional rigid body with scalar translational and rotational state.

Fields§

§mass_properties: MassProperties§position: f64§velocity: f64§angle: f64§angular_velocity: f64

Implementations§

Source §

impl RigidBody1D

Source

pub const fn new( mass_properties: MassProperties, position: f64, velocity: f64, angle: f64, angular_velocity: f64, ) -> Option<RigidBody1D>

Creates a rigid body when the state values are finite.

Source

pub const fn mass(&self) -> f64

Returns the body’s mass.

Source

pub const fn moment_of_inertia(&self) -> f64

Returns the body’s moment of inertia.

Source

pub fn linear_momentum(&self) -> Option<f64>

Computes linear momentum using p = mv.

Source

pub fn angular_momentum(&self) -> Option<f64>

Computes angular momentum using L = Iω.

Source

pub fn linear_kinetic_energy(&self) -> Option<f64>

Computes translational kinetic energy using KE = 0.5mv².

Source

pub fn rotational_kinetic_energy(&self) -> Option<f64>

Computes rotational kinetic energy using KE_rot = 0.5Iω².

Source

pub fn total_kinetic_energy(&self) -> Option<f64>

Computes total kinetic energy as translational plus rotational energy.

Source

pub fn with_impulse(self, impulse: f64) -> Option<RigidBody1D>

Returns a copy with updated velocity after a linear impulse.

§Examples

use use_rigidbody::{MassProperties, RigidBody1D};

let props = MassProperties::new(2.0, 4.0).unwrap();
let body = RigidBody1D::new(props, 10.0, 3.0, 1.0, 5.0).unwrap();

assert_eq!(body.with_impulse(4.0).unwrap().velocity, 5.0);

Source

pub fn with_angular_impulse(self, angular_impulse: f64) -> Option<RigidBody1D>

Returns a copy with updated angular velocity after an angular impulse.

Source

pub fn advanced_kinematically(self, time: f64) -> Option<RigidBody1D>

Advances position and angle kinematically using the current velocities.

This helper updates:

position += velocity * time
angle += angular_velocity * time

§Examples

use use_rigidbody::{MassProperties, RigidBody1D};

let props = MassProperties::new(2.0, 4.0).unwrap();
let body = RigidBody1D::new(props, 10.0, 3.0, 1.0, 5.0).unwrap();
let advanced = body.advanced_kinematically(2.0).unwrap();

assert_eq!(advanced.position, 16.0);
assert_eq!(advanced.angle, 11.0);