Struct ContactPair 

pub struct ContactPair {
    pub collider1: ColliderHandle,
    pub collider2: ColliderHandle,
    pub manifolds: Vec<ContactManifold>,
    pub has_any_active_contact: bool,
    /* private fields */
}

All contact information between two colliding colliders.

When two colliders are touching, a ContactPair stores all the contact points, normals, and forces between them. You can access this through the narrow phase or in event handlers.

Contact manifolds

The contacts are organized into “manifolds” - groups of contact points that share similar properties (like being on the same face). Most collider pairs have 1 manifold, but complex shapes may have multiple.

Use cases

• Reading contact normals for custom physics
• Checking penetration depth
• Analyzing impact forces
• Implementing custom contact responses

Example

if let Some((manifold, contact)) = contact_pair.find_deepest_contact() {
    println!("Deepest penetration: {}", -contact.dist);
    println!("Contact normal: {:?}", manifold.data.normal);
}

Fields

collider1: ColliderHandle

The first collider involved in the contact pair.

collider2: ColliderHandle

The second collider involved in the contact pair.

manifolds: Vec<ContactManifold>

The set of contact manifolds between the two colliders.

All contact manifold contain themselves contact points between the colliders. Note that contact points in the contact manifold do not take into account the Collider::contact_skin which only affects the constraint solver and the SolverContact.

has_any_active_contact: bool

Is there any active contact in this contact pair?

Implementations

impl ContactPair

pub fn clear(&mut self)

Clears all the contacts of this contact pair.

pub fn total_impulse(&self) -> Vector<f32>

The total impulse (force × time) applied by all contacts.

This is the accumulated force that pushed the colliders apart. Useful for determining impact strength.

pub fn total_impulse_magnitude(&self) -> f32

The total magnitude of all contact impulses (sum of lengths, not length of sum).

This is what’s compared against contact_force_event_threshold.

pub fn max_impulse(&self) -> (f32, Vector<f32>)

Finds the strongest contact impulse and its direction.

Returns (magnitude, normal_direction) of the strongest individual contact.

pub fn find_deepest_contact(&self) -> Option<(&ContactManifold, &Contact)>

Finds the contact point with the deepest penetration.

When objects overlap, this returns the contact point that’s penetrating the most. Useful for:

• Finding the “worst” overlap
• Determining primary contact direction
• Custom penetration resolution

Returns both the contact point and its parent manifold.

Example

if let Some((manifold, contact)) = pair.find_deepest_contact() {
    let penetration_depth = -contact.dist;  // Negative dist = penetration
    println!("Deepest penetration: {} units", penetration_depth);
}

Trait Implementations

impl Clone for ContactPair

fn clone(&self) -> ContactPair

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ContactPair

fn default() -> Self

Returns the “default value” for a type.