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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

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

/// Text shadow styling.
///
/// If a `TextShadowComponent` is parented to a `TextComponent`, `TextSystem` will spawn additional
/// shadow renderables for every glyph.
#[derive(Debug, Clone, Copy)]
pub struct TextShadowComponent {
    /// Shadow color (RGBA). Default: black.
    pub rgba: [f32; 4],

    /// Shadow scale multiplier. Default: 1.25.
    pub scale: f32,

    /// Shadow XYZ offset in glyph-local space.
    ///
    /// For Z: `TextSystem` uses this as a *magnitude* to nudge the shadow behind the main glyph
    /// to avoid z-fighting.
    /// Default: [0.0, 0.0, 0.001].
    pub offset: [f32; 3],

    component: Option<ComponentId>,
}

impl TextShadowComponent {
    pub const DEFAULT_RGBA: [f32; 4] = [0.0, 0.0, 0.0, 1.0];
    pub const DEFAULT_SCALE: f32 = 1.25;
    pub const DEFAULT_OFFSET: [f32; 3] = [0.0, 0.0, 0.001];

    pub fn new() -> Self {
        Self {
            rgba: Self::DEFAULT_RGBA,
            scale: Self::DEFAULT_SCALE,
            offset: Self::DEFAULT_OFFSET,
            component: None,
        }
    }

    pub fn with_rgba(mut self, rgba: [f32; 4]) -> Self {
        self.rgba = rgba;
        self
    }

    pub fn with_scale(mut self, scale: f32) -> Self {
        self.scale = scale;
        self
    }

    pub fn with_offset(mut self, offset: [f32; 3]) -> Self {
        self.offset = offset;
        self
    }

    pub fn with_offset_xy(mut self, offset: [f32; 2]) -> Self {
        self.offset[0] = offset[0];
        self.offset[1] = offset[1];
        self
    }

    pub fn with_z_offset(mut self, z_offset: f32) -> Self {
        self.offset[2] = z_offset;
        self
    }
}

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

impl Component for TextShadowComponent {
    fn name(&self) -> &'static str {
        "text_shadow"
    }

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

    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) {
        // TextShadow is consumed by TextSystem at TextComponent expansion time.
    }

    fn to_mms_ast(
        &self,
        _world: &crate::engine::ecs::World,
    ) -> crate::scripting::ast::ComponentExpression {
        use crate::engine::ecs::component::ce_helpers::*;
        ce("TextShadow")
            .with_call(
                "rgba",
                vec![array(nums(self.rgba.iter().map(|&v| v as f64)))],
            )
            .with_call("scale", vec![num(self.scale as f64)])
            .with_call(
                "offset",
                vec![array(nums(self.offset.iter().map(|&v| v as f64)))],
            )
    }
}