nightshade 0.57.0

A cross-platform data-oriented game 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

//! Physics-driven ragdoll for skinned skeletons. A ragdoll replaces the animated
//! pose with a chain of capsule bodies linked by spherical joints; the skeleton
//! is driven from those bodies each frame. The player is paused while ragdolled
//! so the GPU pose pipeline leaves its bones to the physics sync.

use nalgebra_glm::Quat;
use nightshade_ecs::Entity;
use serde::{Deserialize, Serialize};

/// One bone driven by a physics proxy body while ragdolled.
#[derive(Debug, Clone, PartialEq)]
pub struct RagdollLink {
    /// The proxy rigid-body entity.
    pub body: Entity,
    /// The skeleton bone this body drives.
    pub bone: Entity,
    /// Rotation carrying the body's orientation back to the bone's.
    pub rotation_offset: Quat,
}

/// A ragdoll rig over a set of bones. Build it with `start_ragdoll` and tear it
/// down with `recover_ragdoll` (both in the API facade).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Default)]
pub struct Ragdoll {
    /// Bones the ragdoll drives, ordered root to tip.
    pub bones: Vec<String>,
    /// Capsule radius for the proxy bodies.
    pub radius: f32,
    /// Whether the ragdoll is simulating.
    pub active: bool,
    /// Runtime bone-to-body links.
    #[serde(skip)]
    pub links: Vec<RagdollLink>,
}