Collider

Struct Collider 

Source
pub struct Collider {
    pub user_data: u128,
    /* private fields */
}
Expand description

A geometric entity that can be attached to a body so it can be affected by contacts and proximity queries.

To build a new collider, use the ColliderBuilder structure.

Fields§

§user_data: u128

User-defined data associated to this collider.

Implementations§

Source§

impl Collider

Source

pub fn parent(&self) -> Option<RigidBodyHandle>

The rigid body this collider is attached to.

Source

pub fn is_sensor(&self) -> bool

Is this collider a sensor?

Source

pub fn active_hooks(&self) -> ActiveHooks

The physics hooks enabled for this collider.

Source

pub fn set_active_hooks(&mut self, active_hooks: ActiveHooks)

Sets the physics hooks enabled for this collider.

Source

pub fn active_events(&self) -> ActiveEvents

The events enabled for this collider.

Source

pub fn set_active_events(&mut self, active_events: ActiveEvents)

Sets the events enabled for this collider.

Source

pub fn active_collision_types(&self) -> ActiveCollisionTypes

The collision types enabled for this collider.

Source

pub fn set_active_collision_types( &mut self, active_collision_types: ActiveCollisionTypes, )

Sets the collision types enabled for this collider.

Source

pub fn friction(&self) -> f32

The friction coefficient of this collider.

Source

pub fn set_friction(&mut self, coefficient: f32)

Sets the friction coefficient of this collider.

Source

pub fn friction_combine_rule(&self) -> CoefficientCombineRule

The combine rule used by this collider to combine its friction coefficient with the friction coefficient of the other collider it is in contact with.

Source

pub fn set_friction_combine_rule(&mut self, rule: CoefficientCombineRule)

Sets the combine rule used by this collider to combine its friction coefficient with the friction coefficient of the other collider it is in contact with.

Source

pub fn restitution(&self) -> f32

The restitution coefficient of this collider.

Source

pub fn set_restitution(&mut self, coefficient: f32)

Sets the restitution coefficient of this collider.

Source

pub fn restitution_combine_rule(&self) -> CoefficientCombineRule

The combine rule used by this collider to combine its restitution coefficient with the restitution coefficient of the other collider it is in contact with.

Source

pub fn set_restitution_combine_rule(&mut self, rule: CoefficientCombineRule)

Sets the combine rule used by this collider to combine its restitution coefficient with the restitution coefficient of the other collider it is in contact with.

Source

pub fn set_contact_force_event_threshold(&mut self, threshold: f32)

Sets the total force magnitude beyond which a contact force event can be emitted.

Source

pub fn set_sensor(&mut self, is_sensor: bool)

Sets whether or not this is a sensor collider.

Source

pub fn set_translation( &mut self, translation: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>, )

Sets the translational part of this collider’s position.

Source

pub fn set_rotation(&mut self, rotation: Unit<Complex<f32>>)

Sets the rotational part of this collider’s position.

Source

pub fn set_position(&mut self, position: Isometry<f32, Unit<Complex<f32>>, 2>)

Sets the position of this collider.

Source

pub fn position(&self) -> &Isometry<f32, Unit<Complex<f32>>, 2>

The world-space position of this collider.

Source

pub fn translation( &self, ) -> &Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>

The translational part of this collider’s position.

Source

pub fn rotation(&self) -> &Unit<Complex<f32>>

The rotational part of this collider’s position.

Source

pub fn position_wrt_parent( &self, ) -> Option<&Isometry<f32, Unit<Complex<f32>>, 2>>

The position of this collider wrt the body it is attached to.

Source

pub fn set_translation_wrt_parent( &mut self, translation: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>, )

Sets the translational part of this collider’s translation relative to its parent rigid-body.

Source

pub fn set_rotation_wrt_parent(&mut self, rotation: f32)

Sets the rotational part of this collider’s rotaiton relative to its parent rigid-body.

Source

pub fn set_position_wrt_parent( &mut self, pos_wrt_parent: Isometry<f32, Unit<Complex<f32>>, 2>, )

Sets the position of this collider wrt. its parent rigid-body.

Does nothing if the collider is not attached to a rigid-body.

Source

pub fn collision_groups(&self) -> InteractionGroups

The collision groups used by this collider.

Source

pub fn set_collision_groups(&mut self, groups: InteractionGroups)

Sets the collision groups of this collider.

Source

pub fn solver_groups(&self) -> InteractionGroups

The solver groups used by this collider.

Source

pub fn set_solver_groups(&mut self, groups: InteractionGroups)

Sets the solver groups of this collider.

Source

pub fn material(&self) -> &ColliderMaterial

The material (friction and restitution properties) of this collider.

Source

pub fn volume(&self) -> f32

The volume (or surface in 2D) of this collider.

Source

pub fn density(&self) -> f32

The density of this collider.

Source

pub fn mass(&self) -> f32

The mass of this collider.

Source

pub fn set_density(&mut self, density: f32)

Sets the uniform density of this collider.

This will override any previous mass-properties set by Self::set_density, Self::set_mass, Self::set_mass_properties, ColliderBuilder::density, ColliderBuilder::mass, or ColliderBuilder::mass_properties for this collider.

The mass and angular inertia of this collider will be computed automatically based on its shape.

Source

pub fn set_mass(&mut self, mass: f32)

Sets the mass of this collider.

This will override any previous mass-properties set by Self::set_density, Self::set_mass, Self::set_mass_properties, ColliderBuilder::density, ColliderBuilder::mass, or ColliderBuilder::mass_properties for this collider.

The angular inertia of this collider will be computed automatically based on its shape and this mass value.

Source

pub fn set_mass_properties(&mut self, mass_properties: MassProperties)

Sets the mass properties of this collider.

This will override any previous mass-properties set by Self::set_density, Self::set_mass, Self::set_mass_properties, ColliderBuilder::density, ColliderBuilder::mass, or ColliderBuilder::mass_properties for this collider.

Source

pub fn shape(&self) -> &(dyn Shape + 'static)

The geometric shape of this collider.

Source

pub fn shape_mut(&mut self) -> &mut (dyn Shape + 'static)

A mutable reference to the geometric shape of this collider.

If that shape is shared by multiple colliders, it will be cloned first so that self contains a unique copy of that shape that you can modify.

Source

pub fn set_shape(&mut self, shape: SharedShape)

Sets the shape of this collider.

Source

pub fn shared_shape(&self) -> &SharedShape

Retrieve the SharedShape. Also see the shape() function

Source

pub fn compute_aabb(&self) -> AABB

Compute the axis-aligned bounding box of this collider.

Source

pub fn compute_swept_aabb( &self, next_position: &Isometry<f32, Unit<Complex<f32>>, 2>, ) -> AABB

Compute the axis-aligned bounding box of this collider moving from its current position to the given next_position

Source

pub fn mass_properties(&self) -> MassProperties

Compute the local-space mass properties of this collider.

Source

pub fn contact_force_event_threshold(&self) -> f32

The total force magnitude beyond which a contact force event can be emitted.

Trait Implementations§

Source§

impl Clone for Collider

Source§

fn clone(&self) -> Collider

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Into<Collider> for ColliderBuilder

Source§

fn into(self) -> Collider

Converts this type into the (usually inferred) input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

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.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert 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)

Convert &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)

Convert &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
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts 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 more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> Any for T
where T: Any,

Source§

impl<T> CloneAny for T
where T: Any + Clone,

Source§

impl<T> Component for T
where T: Send + Sync + 'static,