Struct let_engine::objects::physics::RigidBodyBuilder

pub struct RigidBodyBuilder {
    pub linvel: Vec2,
    pub angvel: Real,
    pub gravity_scale: Real,
    pub linear_damping: Real,
    pub angular_damping: Real,
    pub can_sleep: bool,
    pub sleeping: bool,
    pub ccd_enabled: bool,
    pub dominance_group: i8,
    pub enabled: bool,
    /* private fields */
}

A builder for rigid-bodies.

Fields

linvel: Vec2

The linear velocity of the rigid-body to be built.

angvel: Real

The angular velocity of the rigid-body to be built.

gravity_scale: Real

The scale factor applied to the gravity affecting the rigid-body to be built, 1.0 by default.

linear_damping: Real

Damping factor for gradually slowing down the translational motion of the rigid-body, 0.0 by default.

angular_damping: Real

Damping factor for gradually slowing down the angular motion of the rigid-body, 0.0 by default.

can_sleep: bool

Whether or not the rigid-body to be created can sleep if it reaches a dynamic equilibrium.

sleeping: bool

Whether or not the rigid-body is to be created asleep.

ccd_enabled: bool

Whether continuous collision-detection is enabled for the rigid-body to be built.

CCD prevents tunneling, but may still allow limited interpenetration of colliders.

dominance_group: i8

The dominance group of the rigid-body to be built.

enabled: bool

Will the rigid-body being built be enabled?

Implementations

impl RigidBodyBuilder

pub fn new(body_type: RigidBodyType) -> Self

Initialize a new builder for a rigid body which is either fixed, dynamic, or kinematic.

pub fn fixed() -> Self

Initializes the builder of a new fixed rigid body.

pub fn kinematic_velocity_based() -> Self

Initializes the builder of a new velocity-based kinematic rigid body.

pub fn kinematic_position_based() -> Self

Initializes the builder of a new position-based kinematic rigid body.

pub fn dynamic() -> Self

Initializes the builder of a new dynamic rigid body.

pub fn gravity_scale(self, scale_factor: Real) -> Self

Sets the scale applied to the gravity force affecting the rigid-body to be created.

pub fn dominance_group(self, group: i8) -> Self

Sets the dominance group of this rigid-body.

pub fn locked_axes(self, locked_axes: LockedAxes) -> Self

Sets the axes along which this rigid-body cannot translate or rotate.

pub fn lock_translations(self) -> Self

Prevents this rigid-body from translating because of forces.

pub fn enabled_translations( self, allow_translations_x: bool, allow_translations_y: bool ) -> Self

Only allow translations of this rigid-body around specific coordinate axes.

pub fn lock_rotations(self) -> Self

Prevents this rigid-body from rotating because of forces.

pub fn linear_damping(self, factor: Real) -> Self

Sets the damping factor for the linear part of the rigid-body motion.

The higher the linear damping factor is, the more quickly the rigid-body will slow-down its translational movement.

pub fn angular_damping(self, factor: Real) -> Self

Sets the damping factor for the angular part of the rigid-body motion.

The higher the angular damping factor is, the more quickly the rigid-body will slow-down its rotational movement.

pub fn linvel(self, linvel: Vec2) -> Self

Sets the initial linear velocity of the rigid-body to be created.

pub fn angvel(self, angvel: Real) -> Self

Sets the initial angular velocity of the rigid-body to be created.

pub fn can_sleep(self, can_sleep: bool) -> Self

Sets whether or not the rigid-body to be created can sleep if it reaches a dynamic equilibrium.

pub fn ccd_enabled(self, enabled: bool) -> Self

Sets whether or not continuous collision-detection is enabled for this rigid-body.

CCD prevents tunneling, but may still allow limited interpenetration of colliders.

pub fn sleeping(self, sleeping: bool) -> Self

Sets whether or not the rigid-body is to be created asleep.

pub fn enabled(self, enabled: bool) -> Self

Enable or disable the rigid-body after its creation.

pub fn build(&self) -> RigidBody

Build a new rigid-body with the parameters configured with this builder.

Trait Implementations

impl Clone for RigidBodyBuilder

fn clone(&self) -> RigidBodyBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RigidBodyBuilder

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

Formats the value using the given formatter.

impl From<RigidBodyBuilder> for RigidBody

fn from(val: RigidBodyBuilder) -> Self

Converts to this type from the input type.

impl PartialEq for RigidBodyBuilder

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RigidBodyBuilder