scena 1.7.2

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

use super::instances::INSTANCE_HANDLE_GENERATION_BASE;
use super::{SceneHostCore, SceneHostError, SceneHostErrorCode};
use crate::{AssetFetcher, NodeKey, SceneImport};

impl<F: AssetFetcher> SceneHostCore<F> {
    pub(super) fn resolve_parent(&self, parent: Option<u64>) -> Result<NodeKey, SceneHostError> {
        parent.map_or(Ok(self.scene.root()), |parent| self.resolve_node(parent))
    }

    pub(super) fn resolve_node(&self, handle: u64) -> Result<NodeKey, SceneHostError> {
        self.node_handles
            .get(
                handle,
                SceneHostErrorCode::NodeHandleNotFound,
                SceneHostErrorCode::StaleNodeHandle,
            )
            .copied()
    }

    pub(super) fn resolve_import(&self, handle: u64) -> Result<&SceneImport, SceneHostError> {
        self.import_handles.get(
            handle,
            SceneHostErrorCode::ImportHandleNotFound,
            SceneHostErrorCode::StaleImportHandle,
        )
    }

    pub(super) fn register_node(&mut self, node: NodeKey) -> u64 {
        if let Some(handle) = self.node_handle_map.get(&node).copied() {
            return handle;
        }
        let handle = self.node_handles.insert(node);
        self.node_handle_map.insert(node, handle);
        handle
    }

    pub(super) fn register_subtree(&mut self, node: NodeKey) {
        self.register_node(node);
        let children = self
            .scene
            .node(node)
            .map(|node| node.children().to_vec())
            .unwrap_or_default();
        for child in children {
            self.register_subtree(child);
        }
    }

    pub(super) fn invalidate_node_handles(&mut self, nodes: &[NodeKey]) {
        for node in nodes {
            let Some(handle) = self.node_handle_map.remove(node) else {
                continue;
            };
            let _ = self.node_handles.remove(
                handle,
                SceneHostErrorCode::NodeHandleNotFound,
                SceneHostErrorCode::StaleNodeHandle,
            );
        }
    }

    pub(super) fn is_instance_root_handle(&self, handle: u64) -> bool {
        handle / (1_u64 << 32) >= u64::from(INSTANCE_HANDLE_GENERATION_BASE)
    }

    pub(super) fn ensure_active_camera(&self) -> Result<(), SceneHostError> {
        if self.scene.camera(self.active_camera).is_some() {
            Ok(())
        } else {
            Err(SceneHostError::new(
                SceneHostErrorCode::NoActiveCamera,
                "SceneHost active camera is missing; create or select a camera before this operation",
            ))
        }
    }
}