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

use crate::diagnostics::LookupError;

use super::super::Scene;
use super::super::import::SceneImport;
use super::{ConnectOptions, ConnectionError, ConnectionPreview, ConnectorFrame};

impl Scene {
    pub fn connect_import_connectors(
        &mut self,
        source_import: &SceneImport,
        source_name: &str,
        target_import: &SceneImport,
        target_name: &str,
        options: ConnectOptions,
    ) -> Result<ConnectionPreview, ConnectionError> {
        let source = source_import
            .connector(source_name)
            .map(ConnectorFrame::from_import_connector)
            .map_err(|error| connector_lookup_error(error, source_name))?;
        let target = target_import
            .connector(target_name)
            .map(ConnectorFrame::from_import_connector)
            .map_err(|error| connector_lookup_error(error, target_name))?;
        self.connect(source, target, options)
    }
}

fn connector_lookup_error(error: LookupError, requested_name: &str) -> ConnectionError {
    match error {
        LookupError::ConnectorNotFound { name } => ConnectionError::MissingConnectorName { name },
        LookupError::AmbiguousConnectorName { name, hosts } => {
            ConnectionError::AmbiguousImportConnector { name, hosts }
        }
        LookupError::StaleImport => ConnectionError::StaleConnectorHandle {
            connector: None,
            name: Some(requested_name.to_string()),
        },
        LookupError::NodeNotFound(node) => ConnectionError::NodeNotFound(node),
        LookupError::AmbiguousNodeName { matches, .. } => {
            ConnectionError::AmbiguousImportConnector {
                name: requested_name.to_string(),
                hosts: matches,
            }
        }
        LookupError::NodeNameNotFound { .. }
        | LookupError::AnchorNotFound { .. }
        | LookupError::AmbiguousAnchorName { .. }
        | LookupError::ClipNotFound { .. }
        | LookupError::AmbiguousClipName { .. }
        | LookupError::VariantNotFound { .. }
        | LookupError::PathNotFound { .. }
        | LookupError::InvalidViewport { .. }
        | LookupError::ImportHasNoBounds
        | LookupError::NodeIsNotMesh { .. }
        | LookupError::NonInvertibleParentTransform { .. }
        | LookupError::GeometryNotFound { .. }
        | LookupError::CameraNotFound(_)
        | LookupError::ClippingPlaneNotFound(_)
        | LookupError::InstanceSetNotFound(_)
        | LookupError::LabelNotFound(_) => ConnectionError::MissingConnectorName {
            name: requested_name.to_string(),
        },
    }
}