concinnity-engine 0.18.69

Runtime engine for Concinnity: ECS schedule, graphics, spawn, streaming
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

// Address a UI component by the asset id it was built from. The overlay
// components are authored as named assets and referenced by id long after the
// world is decomposed, so every HUD / menu / story update resolves an id to the
// live component before writing it.

use crate::components::{Sprite, TextInput, TextLabel};
use crate::ecs::{ComponentSlot, PipelineContext, asset_id::AssetId};

// A component that carries the id of the asset it was built from.
pub(crate) trait Identified: ComponentSlot {
    fn asset_id(&self) -> AssetId;
}

macro_rules! impl_identified {
    ($($t:ty),+ $(,)?) => {
        $(impl Identified for $t {
            fn asset_id(&self) -> AssetId {
                self.asset_id
            }
        })+
    };
}

impl_identified!(Sprite, TextInput, TextLabel);

// The first component of type `C` carrying `id`, or `None` when the world never
// declared it.
pub(crate) fn find_mut<'a, C: Identified>(
    ctx: &'a mut PipelineContext,
    id: AssetId,
) -> Option<&'a mut C> {
    ctx.query_mut::<C>().find(|c| c.asset_id() == id)
}

// Mutate the component of type `C` carrying `id`. An unset reference or a
// component the world never declared is a silent no-op.
pub(crate) fn update<C: Identified>(
    ctx: &mut PipelineContext,
    id: Option<AssetId>,
    apply: impl FnOnce(&mut C),
) {
    let Some(id) = id else { return };
    if let Some(c) = find_mut::<C>(ctx, id) {
        apply(c);
    }
}

// Overwrite the text of the TextLabel carrying `id`, if present.
pub(crate) fn set_text(ctx: &mut PipelineContext, id: AssetId, text: &str) {
    if let Some(l) = find_mut::<TextLabel>(ctx, id) {
        l.content = text.to_string();
    }
}