Trait rapier3d::geometry::ContactPairFilter

pub trait ContactPairFilter: Send + Sync {
    fn filter_contact_pair(
        &self, 
        context: &PairFilterContext<'_>
    ) -> Option<SolverFlags>;
}

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>

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.

Loading content...

Implementors

Loading content...