Struct heron::rapier_plugin::rapier3d::parry::query::details::ContactManifold

pub struct ContactManifold<ManifoldData, ContactData> {
    pub points: Vec<TrackedContact<ContactData>, Global>,
    pub local_n1: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>,
    pub local_n2: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>,
    pub subshape1: u32,
    pub subshape2: u32,
    pub subshape_pos1: Option<Isometry<f32, Unit<Quaternion<f32>>, 3>>,
    pub subshape_pos2: Option<Isometry<f32, Unit<Quaternion<f32>>, 3>>,
    pub data: ManifoldData,
}

A contact manifold between two shapes.

A contact manifold describes a set of contacts between two shapes. All the contact part of the same contact manifold share the same contact normal and contact kinematics.

Fields

points: Vec<TrackedContact<ContactData>, Global>

The contacts points.

local_n1: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>

The contact normal of all the contacts of this manifold, expressed in the local space of the first shape.

local_n2: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>

The contact normal of all the contacts of this manifold, expressed in the local space of the second shape.

subshape1: u32

The first subshape involved in this contact manifold.

This is zero if the first shape is not a composite shape.

subshape2: u32

The second subshape involved in this contact manifold.

This is zero if the second shape is not a composite shape.

subshape_pos1: Option<Isometry<f32, Unit<Quaternion<f32>>, 3>>

If the first shape involved is a composite shape, this contains the position of its subshape involved in this contact.

subshape_pos2: Option<Isometry<f32, Unit<Quaternion<f32>>, 3>>

If the second shape involved is a composite shape, this contains the position of its subshape involved in this contact.

data: ManifoldData

Additional tracked data associated to this contact manifold.

Implementations

impl<ManifoldData, ContactData> ContactManifold<ManifoldData, ContactData>where
    ContactData: Default + Copy,

pub fn new() -> ContactManifold<ManifoldData, ContactData>where
    ManifoldData: Default,

Create a new empty contact-manifold.

pub fn with_data(
    subshape1: u32,
    subshape2: u32,
    data: ManifoldData
) -> ContactManifold<ManifoldData, ContactData>

Create a new empty contact-manifold with the given associated data.

pub fn take(&mut self) -> ContactManifold<ManifoldData, ContactData>where
    ManifoldData: Clone,

Clones self and then remove all contact points from self.

pub fn contacts(&self) -> &[TrackedContact<ContactData>]

The slice of all the contacts, active or not, on this contact manifold.

pub fn try_update_contacts(
    &mut self,
    pos12: &Isometry<f32, Unit<Quaternion<f32>>, 3>
) -> bool

Attempts to use spatial coherence to update contacts points.

pub fn try_update_contacts_eps(
    &mut self,
    pos12: &Isometry<f32, Unit<Quaternion<f32>>, 3>,
    angle_dot_threshold: f32,
    dist_sq_threshold: f32
) -> bool

Attempts to use spatial coherence to update contacts points, using user-defined tolerances.

pub fn match_contacts(&mut self, old_contacts: &[TrackedContact<ContactData>])

Copy data associated to contacts from old_contacts to the new contacts in self based on matching their feature-ids.

pub fn match_contacts_using_positions(
    &mut self,
    old_contacts: &[TrackedContact<ContactData>],
    dist_threshold: f32
)

Copy data associated to contacts from old_contacts to the new contacts in self based on matching the contact positions.

pub fn clear(&mut self)

Removes all the contacts from self.

pub fn find_deepest_contact(&self) -> Option<&TrackedContact<ContactData>>

Returns the contact with the smallest distance (i.e. the largest penetration depth).

Trait Implementations

impl<ManifoldData, ContactData> Clone for ContactManifold<ManifoldData, ContactData>where
    ManifoldData: Clone,
    ContactData: Clone,

fn clone(&self) -> ContactManifold<ManifoldData, ContactData>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<ManifoldData, ContactData> Debug for ContactManifold<ManifoldData, ContactData>where
    ManifoldData: Debug,
    ContactData: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.