mittens-engine 0.7.0

A Vulkan and OpenXR scene engine with ECS, reactive signals, and Meow Meow scripting
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use crate::engine::ecs::ComponentId;
use crate::engine::ecs::component::Component;

/// Debug component: visualises vertex normals of the parent `RenderableComponent`.
///
/// Spawns one thin cyan emissive cube per vertex, oriented along the vertex normal.
/// Cubes are 10× taller along Y than X/Z, making them read as needle-like indicators.
///
/// Attach as a child of a `RenderableComponent`. The visualisation subtree is spawned
/// automatically on init and torn down on cleanup.
#[derive(Debug, Clone)]
pub struct NormalVisualisationComponent {
    /// Thickness of each indicator cube (X and Z scale).
    /// Y scale = thickness * 10.
    pub thickness: f32,

    /// Root ComponentIds of spawned indicator subtrees, stored for cleanup.
    pub spawned_roots: Vec<ComponentId>,

    /// Internal: own ComponentId, stored by set_id.
    component: Option<ComponentId>,
}

impl NormalVisualisationComponent {
    pub fn new() -> Self {
        Self {
            thickness: 0.02,
            spawned_roots: Vec::new(),
            component: None,
        }
    }

    pub fn with_thickness(mut self, t: f32) -> Self {
        self.thickness = t;
        self
    }

    pub fn id(&self) -> Option<ComponentId> {
        self.component
    }
}

impl Default for NormalVisualisationComponent {
    fn default() -> Self {
        Self::new()
    }
}

impl Component for NormalVisualisationComponent {
    fn set_id(&mut self, component: ComponentId) {
        self.component = Some(component);
    }

    fn name(&self) -> &'static str {
        "normal_visualisation"
    }

    fn as_any(&self) -> &dyn std::any::Any {
        self
    }

    fn as_any_mut(&mut self) -> &mut dyn std::any::Any {
        self
    }

    fn init(&mut self, emit: &mut dyn crate::engine::ecs::SignalEmitter, component: ComponentId) {
        emit.push_intent_now(
            component,
            crate::engine::ecs::IntentValue::RegisterNormalVis {
                component_id: component,
            },
        );
    }

    fn cleanup(
        &mut self,
        emit: &mut dyn crate::engine::ecs::SignalEmitter,
        _component: ComponentId,
    ) {
        for root in self.spawned_roots.drain(..) {
            emit.push_intent_now(
                root,
                crate::engine::ecs::IntentValue::RemoveSubtree { component_id: root },
            );
        }
    }

    fn to_mms_ast(
        &self,
        _world: &crate::engine::ecs::World,
    ) -> crate::scripting::ast::ComponentExpression {
        use crate::engine::ecs::component::ce_helpers::*;
        ce_call("NormalVis", "thickness", vec![num(self.thickness as f64)])
    }
}