[−][src]Trait rapier3d::geometry::ContactPairFilter
User-defined filter for potential contact pairs detected by the broad-phase.
This can be used to apply custom logic in order to decide whether two colliders should have their contact computed by the narrow-phase, and if these contact should be solved by the constraints solver
Required methods
fn filter_contact_pair(
&self,
context: &PairFilterContext<'_>
) -> Option<SolverFlags>
&self,
context: &PairFilterContext<'_>
) -> Option<SolverFlags>
Applies the contact pair filter.
Note that using a contact pair filter will replace the default contact filtering which consists of preventing contact computation between two non-dynamic bodies.
This filtering method is called after taking into account the colliders collision groups.
If this returns None
, then the narrow-phase will ignore this contact pair and
not compute any contact manifolds for it.
If this returns Some
, then the narrow-phase will compute contact manifolds for
this pair of colliders, and configure them with the returned solver flags. For
example, if this returns Some(SolverFlags::COMPUTE_IMPULSES)
then the contacts
will be taken into account by the constraints solver. If this returns
Some(SolverFlags::empty())
then the constraints solver will ignore these
contacts.