Struct avian3d::dynamics::rigid_body::Restitution
source · pub struct Restitution {
pub coefficient: Scalar,
pub combine_rule: CoefficientCombine,
}
Expand description
A component for the coefficient of restitution. This controls how bouncy a rigid body is.
The coefficient is between 0 and 1, where 0 corresponds to a perfectly inelastic collision, and 1 corresponds to a perfectly elastic collision that preserves all kinetic energy. The default coefficient is 0.3, and it currently can not be configured at a global level.
When two bodies collide, their restitution coefficients are combined using the specified CoefficientCombine
rule.
§Example
Create a new Restitution
component with a restitution coefficient of 0.4:
Restitution::new(0.4)
Configure how two restitution coefficients are combined with CoefficientCombine
:
Restitution::new(0.4).with_combine_rule(CoefficientCombine::Multiply)
Combine the properties of two Restitution
components:
use avian3d::prelude::*;
let first = Restitution::new(0.8).with_combine_rule(CoefficientCombine::Average);
let second = Restitution::new(0.5).with_combine_rule(CoefficientCombine::Multiply);
// CoefficientCombine::Multiply has higher priority, so the coefficients are multiplied
assert_eq!(
first.combine(second),
Restitution::new(0.4).with_combine_rule(CoefficientCombine::Multiply)
);
Fields§
§coefficient: Scalar
The coefficient of restitution.
This should be between 0 and 1, where 0 corresponds to a perfectly inelastic collision, and 1 corresponds to a perfectly elastic collision that preserves all kinetic energy. The default value is 0.3.
combine_rule: CoefficientCombine
The coefficient combine rule used when two bodies collide.
Implementations§
source§impl Restitution
impl Restitution
sourcepub const ZERO: Self = _
pub const ZERO: Self = _
A restitution coefficient of 0.0 and a combine rule of CoefficientCombine::Average
.
This is equivalent to Restitution::PERFECTLY_INELASTIC
.
sourcepub const PERFECTLY_INELASTIC: Self = _
pub const PERFECTLY_INELASTIC: Self = _
A restitution coefficient of 0.0, which corresponds to a perfectly inelastic collision.
sourcepub const PERFECTLY_ELASTIC: Self = _
pub const PERFECTLY_ELASTIC: Self = _
A restitution coefficient of 1.0, which corresponds to a perfectly elastic collision.
sourcepub fn new(coefficient: Scalar) -> Self
pub fn new(coefficient: Scalar) -> Self
Creates a new Restitution
component with the given restitution coefficient.
sourcepub fn with_combine_rule(&self, combine_rule: CoefficientCombine) -> Self
pub fn with_combine_rule(&self, combine_rule: CoefficientCombine) -> Self
Sets the CoefficientCombine
rule used.
sourcepub fn combine(&self, other: Self) -> Self
pub fn combine(&self, other: Self) -> Self
Combines the properties of two Restitution
components.
Trait Implementations§
source§impl Clone for Restitution
impl Clone for Restitution
source§fn clone(&self) -> Restitution
fn clone(&self) -> Restitution
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Component for Restitution
impl Component for Restitution
source§const STORAGE_TYPE: StorageType = bevy::ecs::component::StorageType::Table
const STORAGE_TYPE: StorageType = bevy::ecs::component::StorageType::Table
source§fn register_component_hooks(_hooks: &mut ComponentHooks)
fn register_component_hooks(_hooks: &mut ComponentHooks)
ComponentHooks
.source§impl Debug for Restitution
impl Debug for Restitution
source§impl Default for Restitution
impl Default for Restitution
source§impl From<f32> for Restitution
impl From<f32> for Restitution
source§impl FromReflect for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl FromReflect for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
source§fn from_reflect(reflect: &dyn Reflect) -> Option<Self>
fn from_reflect(reflect: &dyn Reflect) -> Option<Self>
Self
from a reflected value.source§fn take_from_reflect(
reflect: Box<dyn Reflect>
) -> Result<Self, Box<dyn Reflect>>
fn take_from_reflect( reflect: Box<dyn Reflect> ) -> Result<Self, Box<dyn Reflect>>
Self
using,
constructing the value using from_reflect
if that fails. Read moresource§impl GetTypeRegistration for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl GetTypeRegistration for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
source§fn get_type_registration() -> TypeRegistration
fn get_type_registration() -> TypeRegistration
TypeRegistration
for this type.source§fn register_type_dependencies(registry: &mut TypeRegistry)
fn register_type_dependencies(registry: &mut TypeRegistry)
source§impl PartialEq for Restitution
impl PartialEq for Restitution
source§fn eq(&self, other: &Restitution) -> bool
fn eq(&self, other: &Restitution) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd for Restitution
impl PartialOrd for Restitution
source§fn partial_cmp(&self, other: &Restitution) -> Option<Ordering>
fn partial_cmp(&self, other: &Restitution) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl Reflect for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl Reflect for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
source§fn get_represented_type_info(&self) -> Option<&'static TypeInfo>
fn get_represented_type_info(&self) -> Option<&'static TypeInfo>
source§fn as_any_mut(&mut self) -> &mut dyn Any
fn as_any_mut(&mut self) -> &mut dyn Any
&mut dyn Any
.source§fn into_reflect(self: Box<Self>) -> Box<dyn Reflect>
fn into_reflect(self: Box<Self>) -> Box<dyn Reflect>
source§fn as_reflect(&self) -> &dyn Reflect
fn as_reflect(&self) -> &dyn Reflect
source§fn as_reflect_mut(&mut self) -> &mut dyn Reflect
fn as_reflect_mut(&mut self) -> &mut dyn Reflect
source§fn clone_value(&self) -> Box<dyn Reflect>
fn clone_value(&self) -> Box<dyn Reflect>
Reflect
trait object. Read moresource§fn set(&mut self, value: Box<dyn Reflect>) -> Result<(), Box<dyn Reflect>>
fn set(&mut self, value: Box<dyn Reflect>) -> Result<(), Box<dyn Reflect>>
source§fn reflect_kind(&self) -> ReflectKind
fn reflect_kind(&self) -> ReflectKind
source§fn reflect_ref(&self) -> ReflectRef<'_>
fn reflect_ref(&self) -> ReflectRef<'_>
source§fn reflect_mut(&mut self) -> ReflectMut<'_>
fn reflect_mut(&mut self) -> ReflectMut<'_>
source§fn reflect_owned(self: Box<Self>) -> ReflectOwned
fn reflect_owned(self: Box<Self>) -> ReflectOwned
source§fn reflect_partial_eq(&self, value: &dyn Reflect) -> Option<bool>
fn reflect_partial_eq(&self, value: &dyn Reflect) -> Option<bool>
source§fn apply(&mut self, value: &(dyn Reflect + 'static))
fn apply(&mut self, value: &(dyn Reflect + 'static))
source§fn reflect_hash(&self) -> Option<u64>
fn reflect_hash(&self) -> Option<u64>
source§fn serializable(&self) -> Option<Serializable<'_>>
fn serializable(&self) -> Option<Serializable<'_>>
source§fn is_dynamic(&self) -> bool
fn is_dynamic(&self) -> bool
source§impl Struct for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl Struct for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
source§fn field(&self, name: &str) -> Option<&dyn Reflect>
fn field(&self, name: &str) -> Option<&dyn Reflect>
name
as a &dyn Reflect
.source§fn field_mut(&mut self, name: &str) -> Option<&mut dyn Reflect>
fn field_mut(&mut self, name: &str) -> Option<&mut dyn Reflect>
name
as a
&mut dyn Reflect
.source§fn field_at(&self, index: usize) -> Option<&dyn Reflect>
fn field_at(&self, index: usize) -> Option<&dyn Reflect>
index
as a
&dyn Reflect
.source§fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn Reflect>
fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn Reflect>
index
as a &mut dyn Reflect
.source§fn name_at(&self, index: usize) -> Option<&str>
fn name_at(&self, index: usize) -> Option<&str>
index
.source§fn iter_fields(&self) -> FieldIter<'_>
fn iter_fields(&self) -> FieldIter<'_>
source§fn clone_dynamic(&self) -> DynamicStruct
fn clone_dynamic(&self) -> DynamicStruct
DynamicStruct
.source§impl TypePath for Restitution
impl TypePath for Restitution
source§fn type_path() -> &'static str
fn type_path() -> &'static str
source§fn short_type_path() -> &'static str
fn short_type_path() -> &'static str
source§fn type_ident() -> Option<&'static str>
fn type_ident() -> Option<&'static str>
source§fn crate_name() -> Option<&'static str>
fn crate_name() -> Option<&'static str>
source§impl Typed for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl Typed for Restitutionwhere
Self: Any + Send + Sync,
Scalar: FromReflect + TypePath + RegisterForReflection,
CoefficientCombine: FromReflect + TypePath + RegisterForReflection,
impl Copy for Restitution
impl StructuralPartialEq for Restitution
Auto Trait Implementations§
impl Freeze for Restitution
impl RefUnwindSafe for Restitution
impl Send for Restitution
impl Sync for Restitution
impl Unpin for Restitution
impl UnwindSafe for Restitution
Blanket Implementations§
source§impl<T, U> AsBindGroupShaderType<U> for T
impl<T, U> AsBindGroupShaderType<U> for T
source§fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
T
ShaderType
for self
. When used in AsBindGroup
derives, it is safe to assume that all images in self
exist.source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<C> Bundle for Cwhere
C: Component,
impl<C> Bundle for Cwhere
C: Component,
fn component_ids( components: &mut Components, storages: &mut Storages, ids: &mut impl FnMut(ComponentId) )
unsafe fn from_components<T, F>(ctx: &mut T, func: &mut F) -> C
source§fn get_component_ids(
components: &Components,
ids: &mut impl FnMut(Option<ComponentId>)
)
fn get_component_ids( components: &Components, ids: &mut impl FnMut(Option<ComponentId>) )
source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
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
.source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
source§impl<C> DynamicBundle for Cwhere
C: Component,
impl<C> DynamicBundle for Cwhere
C: Component,
fn get_components(self, func: &mut impl FnMut(StorageType, OwningPtr<'_>))
source§impl<T> DynamicTypePath for Twhere
T: TypePath,
impl<T> DynamicTypePath for Twhere
T: TypePath,
source§fn reflect_type_path(&self) -> &str
fn reflect_type_path(&self) -> &str
TypePath::type_path
.source§fn reflect_short_type_path(&self) -> &str
fn reflect_short_type_path(&self) -> &str
source§fn reflect_type_ident(&self) -> Option<&str>
fn reflect_type_ident(&self) -> Option<&str>
TypePath::type_ident
.source§fn reflect_crate_name(&self) -> Option<&str>
fn reflect_crate_name(&self) -> Option<&str>
TypePath::crate_name
.source§fn reflect_module_path(&self) -> Option<&str>
fn reflect_module_path(&self) -> Option<&str>
source§impl<T> FromWorld for Twhere
T: Default,
impl<T> FromWorld for Twhere
T: Default,
source§fn from_world(_world: &mut World) -> T
fn from_world(_world: &mut World) -> T
Self
using data from the given World
.source§impl<S> GetField for Swhere
S: Struct,
impl<S> GetField for Swhere
S: Struct,
source§impl<T> GetPath for T
impl<T> GetPath for T
source§fn reflect_path<'p>(
&self,
path: impl ReflectPath<'p>
) -> Result<&(dyn Reflect + 'static), ReflectPathError<'p>>
fn reflect_path<'p>( &self, path: impl ReflectPath<'p> ) -> Result<&(dyn Reflect + 'static), ReflectPathError<'p>>
path
. Read moresource§fn reflect_path_mut<'p>(
&mut self,
path: impl ReflectPath<'p>
) -> Result<&mut (dyn Reflect + 'static), ReflectPathError<'p>>
fn reflect_path_mut<'p>( &mut self, path: impl ReflectPath<'p> ) -> Result<&mut (dyn Reflect + 'static), ReflectPathError<'p>>
path
. Read moresource§fn path<'p, T>(
&self,
path: impl ReflectPath<'p>
) -> Result<&T, ReflectPathError<'p>>where
T: Reflect,
fn path<'p, T>(
&self,
path: impl ReflectPath<'p>
) -> Result<&T, ReflectPathError<'p>>where
T: Reflect,
path
. Read moresource§fn path_mut<'p, T>(
&mut self,
path: impl ReflectPath<'p>
) -> Result<&mut T, ReflectPathError<'p>>where
T: Reflect,
fn path_mut<'p, T>(
&mut self,
path: impl ReflectPath<'p>
) -> Result<&mut T, ReflectPathError<'p>>where
T: Reflect,
path
. Read moresource§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read moresource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.