scena 1.7.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

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

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

impl Scene {
    pub fn set_mesh_material(
        &mut self,
        node: NodeKey,
        material: MaterialHandle,
    ) -> Result<(), LookupError> {
        let node_data = self
            .nodes
            .get_mut(node)
            .ok_or(LookupError::NodeNotFound(node))?;
        let NodeKind::Mesh(mesh) = &mut node_data.kind else {
            return Err(LookupError::NodeIsNotMesh { node });
        };
        if mesh.material != material {
            mesh.material = material;
            self.structure_revision = self.structure_revision.saturating_add(1);
        }
        Ok(())
    }

    pub fn set_node_tint(&mut self, node: NodeKey, tint: Option<Color>) -> Result<(), LookupError> {
        let node = self
            .nodes
            .get_mut(node)
            .ok_or(LookupError::NodeNotFound(node))?;
        if node.tint != tint {
            let structural = tint_requires_structure_revision(node.tint)
                || tint_requires_structure_revision(tint);
            node.tint = tint;
            if structural {
                self.structure_revision = self.structure_revision.saturating_add(1);
            } else {
                self.appearance_revision = self.appearance_revision.saturating_add(1);
            }
        }
        Ok(())
    }

    pub fn node_tint(&self, node: NodeKey) -> Result<Option<Color>, LookupError> {
        self.nodes
            .get(node)
            .map(|node| node.tint)
            .ok_or(LookupError::NodeNotFound(node))
    }
}

fn tint_requires_structure_revision(tint: Option<Color>) -> bool {
    tint.is_some_and(|tint| tint.a < 1.0)
}