rapier2d 0.35.0-beta.0

2-dimensional physics engine in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use crate::alloc_prelude::*;
use crate::dynamics::solver::contact_constraint::{
    ContactWithCoulombFriction, ContactWithCoulombFrictionBuilder, GenericContactConstraint,
    GenericContactConstraintBuilder,
};
use crate::dynamics::solver::interaction_groups::InteractionGroups;
use crate::dynamics::{ImpulseJoint, JointAxesMask};
use crate::math::DVector;
use parry::math::SimdReal;

#[cfg(feature = "dim3")]
use crate::dynamics::solver::contact_constraint::{
    ContactWithTwistFriction, ContactWithTwistFrictionBuilder,
};

// NOTE: the constraints count from contacts is always 1 since the max number of solver contacts
//       matches the max number of contacts per constraint.
/// The number of velocity-constraint rows generated by `joint`.
pub fn joint_num_constraints(joint: &ImpulseJoint) -> usize {
    joint_data_num_constraints(&joint.data)
}

/// The number of velocity-constraint rows generated by a joint with data `joint`.
pub fn joint_data_num_constraints(joint: &crate::dynamics::GenericJoint) -> usize {
    let locked_axes = joint.locked_axes.bits();
    let motor_axes = joint.motor_axes.bits() & !locked_axes;
    let limit_axes = joint.limit_axes.bits() & !locked_axes;
    let coupled_axes = joint.coupled_axes.bits();

    (motor_axes & !coupled_axes).count_ones() as usize
        + ((motor_axes & coupled_axes) & JointAxesMask::ANG_AXES.bits() != 0) as usize
        + ((motor_axes & coupled_axes) & JointAxesMask::LIN_AXES.bits() != 0) as usize
        + locked_axes.count_ones() as usize
        + (limit_axes & !coupled_axes).count_ones() as usize
        + ((limit_axes & coupled_axes) & JointAxesMask::ANG_AXES.bits() != 0) as usize
        + ((limit_axes & coupled_axes) & JointAxesMask::LIN_AXES.bits() != 0) as usize
}

pub(crate) struct ContactConstraintsSet {
    pub generic_jacobians: DVector,
    /// Greedy body-mask grouper, only used for the overflow-color manifolds
    /// (they may share bodies, so the color-run chunking can't cover them).
    pub interaction_groups: InteractionGroups,

    pub generic_velocity_constraints: Vec<GenericContactConstraint>,
    pub simd_velocity_coulomb_constraints: Vec<ContactWithCoulombFriction<SimdReal>>,
    #[cfg(feature = "dim3")]
    pub simd_velocity_twist_constraints: Vec<ContactWithTwistFriction<SimdReal>>,

    pub generic_velocity_constraints_builder: Vec<GenericContactConstraintBuilder>,
    pub simd_velocity_coulomb_constraints_builder: Vec<ContactWithCoulombFrictionBuilder>,
    #[cfg(feature = "dim3")]
    pub simd_velocity_twist_constraints_builder: Vec<ContactWithTwistFrictionBuilder<SimdReal>>,
}

impl ContactConstraintsSet {
    pub fn new() -> Self {
        Self {
            generic_jacobians: DVector::zeros(0),
            interaction_groups: InteractionGroups::new(),
            generic_velocity_constraints: vec![],
            simd_velocity_coulomb_constraints: vec![],
            generic_velocity_constraints_builder: vec![],
            simd_velocity_coulomb_constraints_builder: vec![],
            #[cfg(feature = "dim3")]
            simd_velocity_twist_constraints: vec![],
            #[cfg(feature = "dim3")]
            simd_velocity_twist_constraints_builder: vec![],
        }
    }
}