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

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

use crate::{error::Result, scene::Camera, serialization::SerializedProjection};

/// Serialized representation of a `Camera`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SerializedCamera<T: RealField + Copy> {
    /// Camera projection mode
    pub projection: SerializedProjection<T>,
    /// View point.
    pub position: [T; 3],
    /// Target position.
    pub look_at: [T; 3],
    /// Resolution of the camera in pixels (width, height).
    pub resolution: [usize; 2],
}

impl<T: RealField + Copy + ToPrimitive> SerializedCamera<T> {
    /// Construct a `Camera` instance.
    ///
    /// # Errors
    ///
    /// Returns an error if:
    /// - Projection building fails
    /// - Camera construction fails due to invalid parameters
    pub fn build(self) -> Result<Camera<T>> {
        let position = Point3::new(self.position[0], self.position[1], self.position[2]);
        let look_at = Point3::new(self.look_at[0], self.look_at[1], self.look_at[2]);
        let projection = self.projection.build()?;
        Camera::new(position, look_at, projection, self.resolution)
    }
}