geodesic 0.1.0

A Rust library for constructing and sampling 3D geometric scenes.
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

use nalgebra::RealField;
use num_traits::ToPrimitive;
use serde::{Deserialize, Serialize};

use crate::{
    error::{Result, SceneError},
    scene::{Assets, Scene, SceneObject},
    serialization::SerializedSceneObject,
};

/// Serialized representation of a `Scene`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SerializedScene<T: RealField + Copy> {
    /// Objects within the `Scene`.
    pub objects: Vec<SerializedSceneObject<T>>,
}

impl<T: RealField + Copy + ToPrimitive> SerializedScene<T> {
    /// Construct a `Scene` instance.
    ///
    /// # Errors
    ///
    /// Returns an error if:
    /// - Any scene object fails to build
    /// - The resulting objects vector is empty
    /// - Scene construction fails
    pub fn build(self, assets: &Assets<T>) -> Result<Scene<'_, T>> {
        let objects: Vec<SceneObject<T>> = self
            .objects
            .into_iter()
            .map(|obj| obj.build(assets))
            .collect::<Result<Vec<_>>>()?;

        if objects.is_empty() {
            return Err(SceneError::EmptyScene.into());
        }
        Scene::new(&assets.bvh_config, objects)
    }
}