concinnity-core 0.19.0

Runtime vocabulary for the Concinnity engine: GPU layouts, ECS components, registry, CPU kernels
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

// src/components/ground_probes.rs

use alloc::vec::Vec;

use crate::ecs::SkinnedMeshHandle;

/// One downward ground probe: a ray and, once physics has answered it, the
/// hit it found.
#[derive(Debug, Clone, Copy, Default)]
pub struct GroundProbe {
    /// Ray origin in world space.
    pub origin: [f32; 3],
    /// Maximum hit distance along -Y from the origin.
    pub max_dist: f32,
    /// The surface point and normal the ray found, or `None` (unanswered,
    /// or no ground within range).
    pub hit: Option<([f32; 3], [f32; 3])>,
}

/// Runtime-only ground-probe exchange for one animated character.
///
/// `AnimationSystem` publishes one per graph target with IK chains and
/// refreshes each probe's ray from the animated end-joint position every
/// frame; `PhysicsSystem` (which steps earlier) answers the previous frame's
/// rays with raycast hits. The one-frame-stale ray origin is invisible at
/// animation rates.
///
/// Not authored in world files: it has no `args`.
#[derive(Debug, Clone, Default)]
pub struct GroundProbes {
    /// The `SkinnedMesh` resource whose IK chains these probes serve.
    pub target: SkinnedMeshHandle,
    /// One probe per IK chain, in the graph's `ik_chains` order.
    pub probes: Vec<GroundProbe>,
}