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

use crate::assets::SceneAsset;
use crate::diagnostics::{InstantiateError, LookupError};
use crate::scene::{NodeKey, Scene};

use super::{ImportOptions, SceneImport};

impl Scene {
    pub fn instantiate(
        &mut self,
        scene_asset: &SceneAsset,
    ) -> Result<SceneImport, InstantiateError> {
        self.instantiate_with(scene_asset, ImportOptions::gltf_default())
    }

    pub fn instantiate_with(
        &mut self,
        scene_asset: &SceneAsset,
        options: ImportOptions,
    ) -> Result<SceneImport, InstantiateError> {
        self.instantiate_with_parent(self.root(), scene_asset, options)
    }

    pub fn instantiate_under(
        &mut self,
        parent: NodeKey,
        scene_asset: &SceneAsset,
        options: ImportOptions,
    ) -> crate::Result<SceneImport> {
        if self.node(parent).is_none() {
            return Err(LookupError::NodeNotFound(parent).into());
        }
        self.instantiate_with_parent(parent, scene_asset, options)
            .map_err(Into::into)
    }
}