rapier3d-mjcf 0.34.0

MuJoCo MJCF loader for the 3D rapier physics engine.
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

//! Handles produced by inserting an [`MjcfRobot`](super::MjcfRobot) into
//! rapier. The body / joint / actuator handles are organized parallel to
//! their counterparts in [`MjcfRobot`](super::MjcfRobot) so callers can
//! cross-reference by index.

use mjcf_rs::extras::Actuator as MjcfActuator;

use rapier3d::dynamics::{ImpulseJointHandle, RigidBodyHandle};
use rapier3d::geometry::ColliderHandle;

/// A handle to one inserted collider.
#[derive(Clone, Debug)]
pub struct MjcfColliderHandle {
    /// Rapier collider handle.
    pub handle: ColliderHandle,
}

/// A handle to one inserted rigid-body.
#[derive(Clone, Debug)]
pub struct MjcfBodyHandle {
    /// Rapier rigid-body handle.
    pub body: RigidBodyHandle,
    /// Inserted colliders.
    pub colliders: Vec<MjcfColliderHandle>,
}

/// A handle to one inserted joint (typed by the joint set used).
#[derive(Clone, Debug)]
pub struct MjcfJointHandle<H> {
    /// Joint handle (kind depends on the joint set).
    pub joint: H,
    /// Parent rigid-body.
    pub link1: RigidBodyHandle,
    /// Child rigid-body.
    pub link2: RigidBodyHandle,
}

/// Per-actuator handle resolved against the inserted joint set. Returned
/// alongside [`MjcfRobotHandles::joints`] so callers can drive each
/// actuator without having to walk the actuator → joint-index → handle
/// indirection themselves.
#[derive(Clone, Debug)]
pub struct MjcfActuatorHandle<H> {
    /// Original actuator metadata.
    pub actuator: MjcfActuator,
    /// Joint handle the actuator drives, if any.
    pub joint: Option<H>,
}

/// All handles produced by inserting a [`MjcfRobot`](super::MjcfRobot) into rapier.
#[derive(Clone, Debug)]
pub struct MjcfRobotHandles<H> {
    /// Per-body handles. Aligned with [`MjcfRobot::bodies`](super::MjcfRobot::bodies) (entry 0 is
    /// the world body and is left at `None`).
    pub bodies: Vec<Option<MjcfBodyHandle>>,
    /// Per-joint handles, aligned with [`MjcfRobot::joints`](super::MjcfRobot::joints).
    pub joints: Vec<MjcfJointHandle<H>>,
    /// Per-equality-constraint handles. Always inserted as impulse joints.
    pub equality_joints: Vec<MjcfJointHandle<ImpulseJointHandle>>,
    /// Per-actuator handles, aligned with [`MjcfRobot::actuators`](super::MjcfRobot::actuators).
    pub actuators: Vec<MjcfActuatorHandle<H>>,
}