scena 1.1.0

A Rust-native scene-graph renderer with typed scene state, glTF assets, and explicit prepare/render lifecycles.
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
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124

use crate::diagnostics::LookupError;
use crate::material::Color;

use super::{LabelKey, NodeKey, NodeKind, Scene, Transform};

#[derive(Debug, Clone, PartialEq)]
pub struct LabelDesc {
    text: String,
    rasterization: LabelRasterization,
    billboard: LabelBillboard,
    color: Color,
    size: f32,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum LabelRasterization {
    Sdf,
    Msdf,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum LabelBillboard {
    ScreenAligned,
}

impl Scene {
    pub fn add_label(
        &mut self,
        parent: NodeKey,
        label: LabelDesc,
        transform: Transform,
    ) -> Result<LabelKey, LookupError> {
        let label_key = self.labels.insert(label);
        if let Err(error) = self.insert_node(parent, NodeKind::Label(label_key), transform) {
            self.labels.remove(label_key);
            return Err(error);
        }
        Ok(label_key)
    }

    pub fn label(&self, label: LabelKey) -> Option<&LabelDesc> {
        self.labels.get(label)
    }

    pub fn set_label_text(
        &mut self,
        label: LabelKey,
        text: impl Into<String>,
    ) -> Result<(), LookupError> {
        let label = self
            .labels
            .get_mut(label)
            .ok_or(LookupError::LabelNotFound(label))?;
        let text = text.into();
        if label.text != text {
            label.text = text;
            self.structure_revision = self.structure_revision.saturating_add(1);
        }
        Ok(())
    }
}

impl LabelDesc {
    pub fn sdf(text: impl Into<String>) -> Self {
        Self::new(text, LabelRasterization::Sdf)
    }

    pub fn msdf(text: impl Into<String>) -> Self {
        Self::new(text, LabelRasterization::Msdf)
    }

    pub fn text(&self) -> &str {
        &self.text
    }

    pub const fn rasterization(&self) -> LabelRasterization {
        self.rasterization
    }

    pub const fn billboard(&self) -> LabelBillboard {
        self.billboard
    }

    pub const fn color(&self) -> Color {
        self.color
    }

    pub const fn size(&self) -> f32 {
        self.size
    }

    pub fn with_color(mut self, color: Color) -> Self {
        self.color = color;
        self
    }

    pub fn with_size(mut self, size: f32) -> Self {
        self.size = positive_or(size, 1.0);
        self
    }

    pub const fn with_billboard(mut self, billboard: LabelBillboard) -> Self {
        self.billboard = billboard;
        self
    }

    fn new(text: impl Into<String>, rasterization: LabelRasterization) -> Self {
        Self {
            text: text.into(),
            rasterization,
            billboard: LabelBillboard::ScreenAligned,
            color: Color::WHITE,
            size: 1.0,
        }
    }
}

fn positive_or(value: f32, fallback: f32) -> f32 {
    if !value.is_finite() || value <= 0.0 {
        fallback
    } else {
        value
    }
}