Struct rapier3d::dynamics::RigidBodyBuilder
source · [−]pub struct RigidBodyBuilder {
pub position: Isometry<Real>,
pub linvel: Vector<Real>,
pub angvel: AngVector<Real>,
pub gravity_scale: Real,
pub linear_damping: Real,
pub angular_damping: Real,
pub additional_mass_properties: MassProperties,
pub can_sleep: bool,
pub sleeping: bool,
pub ccd_enabled: bool,
pub dominance_group: i8,
pub user_data: u128,
/* private fields */
}
Expand description
A builder for rigid-bodies.
Fields
position: Isometry<Real>
The initial position of the rigid-body to be built.
linvel: Vector<Real>
The linear velocity of the rigid-body to be built.
angvel: AngVector<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.
additional_mass_properties: MassProperties
The additional mass properties of the rigid-body being built. See RigidBodyBuilder::additional_mass_properties
for more information.
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.
user_data: u128
An arbitrary user-defined 128-bit integer associated to the rigid-bodies built by this builder.
Implementations
sourceimpl RigidBodyBuilder
impl RigidBodyBuilder
sourcepub fn new(body_type: RigidBodyType) -> Self
pub fn new(body_type: RigidBodyType) -> Self
Initialize a new builder for a rigid body which is either fixed, dynamic, or kinematic.
sourcepub fn new_static() -> Self
👎 Deprecated: use RigidBodyBuilder::fixed()
instead
pub fn new_static() -> Self
use RigidBodyBuilder::fixed()
instead
Initializes the builder of a new fixed rigid body.
sourcepub fn new_kinematic_velocity_based() -> Self
👎 Deprecated: use RigidBodyBuilder::kinematic_velocity_based()
instead
pub fn new_kinematic_velocity_based() -> Self
use RigidBodyBuilder::kinematic_velocity_based()
instead
Initializes the builder of a new velocity-based kinematic rigid body.
sourcepub fn new_kinematic_position_based() -> Self
👎 Deprecated: use RigidBodyBuilder::kinematic_position_based()
instead
pub fn new_kinematic_position_based() -> Self
use RigidBodyBuilder::kinematic_position_based()
instead
Initializes the builder of a new position-based kinematic rigid body.
sourcepub fn kinematic_velocity_based() -> Self
pub fn kinematic_velocity_based() -> Self
Initializes the builder of a new velocity-based kinematic rigid body.
sourcepub fn kinematic_position_based() -> Self
pub fn kinematic_position_based() -> Self
Initializes the builder of a new position-based kinematic rigid body.
sourcepub fn gravity_scale(self, scale_factor: Real) -> Self
pub fn gravity_scale(self, scale_factor: Real) -> Self
Sets the scale applied to the gravity force affecting the rigid-body to be created.
sourcepub fn dominance_group(self, group: i8) -> Self
pub fn dominance_group(self, group: i8) -> Self
Sets the dominance group of this rigid-body.
sourcepub fn translation(self, translation: Vector<Real>) -> Self
pub fn translation(self, translation: Vector<Real>) -> Self
Sets the initial translation of the rigid-body to be created.
sourcepub fn rotation(self, angle: AngVector<Real>) -> Self
pub fn rotation(self, angle: AngVector<Real>) -> Self
Sets the initial orientation of the rigid-body to be created.
sourcepub fn position(self, pos: Isometry<Real>) -> Self
pub fn position(self, pos: Isometry<Real>) -> Self
Sets the initial position (translation and orientation) of the rigid-body to be created.
sourcepub fn user_data(self, data: u128) -> Self
pub fn user_data(self, data: u128) -> Self
An arbitrary user-defined 128-bit integer associated to the rigid-bodies built by this builder.
sourcepub fn additional_mass_properties(self, props: MassProperties) -> Self
pub fn additional_mass_properties(self, props: MassProperties) -> Self
Sets the additional mass properties of the rigid-body being built.
Note that “additional” means that the final mass properties of the rigid-bodies depends on the initial mass-properties of the rigid-body (set by this method) to which is added the contributions of all the colliders with non-zero density attached to this rigid-body.
Therefore, if you want your provided mass properties to be the final mass properties of your rigid-body, don’t attach colliders to it, or only attach colliders with densities equal to zero.
sourcepub fn locked_axes(self, locked_axes: LockedAxes) -> Self
pub fn locked_axes(self, locked_axes: LockedAxes) -> Self
Sets the axes along which this rigid-body cannot translate or rotate.
sourcepub fn lock_translations(self) -> Self
pub fn lock_translations(self) -> Self
Prevents this rigid-body from translating because of forces.
sourcepub fn restrict_translations(
self,
allow_translations_x: bool,
allow_translations_y: bool,
allow_translations_z: bool
) -> Self
pub fn restrict_translations(
self,
allow_translations_x: bool,
allow_translations_y: bool,
allow_translations_z: bool
) -> Self
Only allow translations of this rigid-body around specific coordinate axes.
sourcepub fn lock_rotations(self) -> Self
pub fn lock_rotations(self) -> Self
Prevents this rigid-body from rotating because of forces.
sourcepub fn restrict_rotations(
self,
allow_rotations_x: bool,
allow_rotations_y: bool,
allow_rotations_z: bool
) -> Self
pub fn restrict_rotations(
self,
allow_rotations_x: bool,
allow_rotations_y: bool,
allow_rotations_z: bool
) -> Self
Only allow rotations of this rigid-body around specific coordinate axes.
sourcepub fn additional_mass(self, mass: Real) -> Self
pub fn additional_mass(self, mass: Real) -> Self
Sets the additional mass of the rigid-body being built.
This is only the “additional” mass because the total mass of the rigid-body is equal to the sum of this additional mass and the mass computed from the colliders (with non-zero densities) attached to this rigid-body.
sourcepub fn mass(self, mass: Real) -> Self
👎 Deprecated: renamed to additional_mass
.
pub fn mass(self, mass: Real) -> Self
renamed to additional_mass
.
Sets the additional mass of the rigid-body being built.
This is only the “additional” mass because the total mass of the rigid-body is equal to the sum of this additional mass and the mass computed from the colliders (with non-zero densities) attached to this rigid-body.
sourcepub fn additional_principal_angular_inertia(
self,
inertia: AngVector<Real>
) -> Self
pub fn additional_principal_angular_inertia(
self,
inertia: AngVector<Real>
) -> Self
Sets the additional principal angular inertia of this rigid-body.
This is only the “additional” angular inertia because the total angular inertia of the rigid-body is equal to the sum of this additional value and the angular inertia computed from the colliders (with non-zero densities) attached to this rigid-body.
sourcepub fn principal_angular_inertia(self, inertia: AngVector<Real>) -> Self
👎 Deprecated: renamed to additional_principal_angular_inertia
.
pub fn principal_angular_inertia(self, inertia: AngVector<Real>) -> Self
renamed to additional_principal_angular_inertia
.
Sets the principal angular inertia of this rigid-body.
sourcepub fn principal_inertia(self, inertia: AngVector<Real>) -> Self
👎 Deprecated: renamed to additional_principal_angular_inertia
.
pub fn principal_inertia(self, inertia: AngVector<Real>) -> Self
renamed to additional_principal_angular_inertia
.
Use self.principal_angular_inertia
instead.
sourcepub fn linear_damping(self, factor: Real) -> Self
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.
sourcepub fn angular_damping(self, factor: Real) -> Self
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.
sourcepub fn linvel(self, linvel: Vector<Real>) -> Self
pub fn linvel(self, linvel: Vector<Real>) -> Self
Sets the initial linear velocity of the rigid-body to be created.
sourcepub fn angvel(self, angvel: AngVector<Real>) -> Self
pub fn angvel(self, angvel: AngVector<Real>) -> Self
Sets the initial angular velocity of the rigid-body to be created.
sourcepub fn can_sleep(self, can_sleep: bool) -> Self
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.
sourcepub fn ccd_enabled(self, enabled: bool) -> Self
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.
Trait Implementations
sourceimpl Clone for RigidBodyBuilder
impl Clone for RigidBodyBuilder
sourcefn clone(&self) -> RigidBodyBuilder
fn clone(&self) -> RigidBodyBuilder
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl Debug for RigidBodyBuilder
impl Debug for RigidBodyBuilder
sourceimpl Into<RigidBody> for RigidBodyBuilder
impl Into<RigidBody> for RigidBodyBuilder
sourceimpl PartialEq<RigidBodyBuilder> for RigidBodyBuilder
impl PartialEq<RigidBodyBuilder> for RigidBodyBuilder
sourcefn eq(&self, other: &RigidBodyBuilder) -> bool
fn eq(&self, other: &RigidBodyBuilder) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &RigidBodyBuilder) -> bool
fn ne(&self, other: &RigidBodyBuilder) -> bool
This method tests for !=
.
impl StructuralPartialEq for RigidBodyBuilder
Auto Trait Implementations
impl RefUnwindSafe for RigidBodyBuilder
impl Send for RigidBodyBuilder
impl Sync for RigidBodyBuilder
impl Unpin for RigidBodyBuilder
impl UnwindSafe for RigidBodyBuilder
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Downcast for T where
T: Any,
impl<T> Downcast for T where
T: Any,
sourcefn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
Convert Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
sourcefn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more
sourceimpl<T> DowncastSync for T where
T: Any + Send + Sync,
impl<T> DowncastSync for T where
T: Any + Send + Sync,
impl<T> Pointable for T
impl<T> Pointable for T
sourceimpl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
sourcefn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
The inverse inclusion map: attempts to construct self
from the equivalent element of its
superset. Read more
sourcefn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
Checks if self
is actually part of its subset T
(and can be converted to it).
sourcefn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
Use with care! Same as self.to_subset
but without any property checks. Always succeeds.
sourcefn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
The inclusion map: converts self
to the equivalent element of its superset.
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more