Struct bevy_rapier2d::prelude::ContactModificationContext

pub struct ContactModificationContext<'a, Bodies, Colliders> {
    pub bodies: &'a Bodies,
    pub colliders: &'a Colliders,
    pub collider1: ColliderHandle,
    pub collider2: ColliderHandle,
    pub rigid_body1: Option<RigidBodyHandle>,
    pub rigid_body2: Option<RigidBodyHandle>,
    pub manifold: &'a ContactManifold<ContactManifoldData, ContactData>,
    pub solver_contacts: &'a mut Vec<SolverContact, Global>,
    pub normal: &'a mut Matrix<f32, Const<{_: usize}>, Const<1_usize>, ArrayStorage<f32, 2_usize, 1_usize>>,
    pub user_data: &'a mut u32,
}

Context given to custom contact modifiers to modify the contacts seen by the constraints solver.

Fields

bodies: &'a Bodies

The set of rigid-bodies.

colliders: &'a Colliders

The set of colliders.

collider1: ColliderHandle

The handle of the first collider involved in the potential collision.

collider2: ColliderHandle

The handle of the first collider involved in the potential collision.

rigid_body1: Option<RigidBodyHandle>

The handle of the first body involved in the potential collision.

rigid_body2: Option<RigidBodyHandle>

The handle of the first body involved in the potential collision.

manifold: &'a ContactManifold<ContactManifoldData, ContactData>

The contact manifold.

solver_contacts: &'a mut Vec<SolverContact, Global>

The solver contacts that can be modified.

normal: &'a mut Matrix<f32, Const<{_: usize}>, Const<1_usize>, ArrayStorage<f32, 2_usize, 1_usize>>

The contact normal that can be modified.

user_data: &'a mut u32

User-defined data attached to the manifold.

Implementations

impl<'a, Bodies, Colliders> ContactModificationContext<'a, Bodies, Colliders>

pub fn update_as_oneway_platform(
    &mut self,
    allowed_local_n1: &Matrix<f32, Const<{_: usize}>, Const<1_usize>, ArrayStorage<f32, 2_usize, 1_usize>>,
    allowed_angle: f32
)

Helper function to update self to emulate a oneway-platform.

The “oneway” behavior will only allow contacts between two colliders if the local contact normal of the first collider involved in the contact is almost aligned with the provided allowed_local_n1 direction.

To make this method work properly it must be called as part of the PhysicsHooks::modify_solver_contacts method at each timestep, for each contact manifold involving a one-way platform. The self.user_data field must not be modified from the outside of this method.