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

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

use crate::{error::Result, scene::Projection, traits::FallibleNumeric};

const DEGREES_TO_RADIANS: f64 = std::f64::consts::PI / 180.0;

/// Serialized representation of a `Camera`'s `Projection`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum SerializedProjection<T: RealField + Copy> {
    /// Perspective projection with a field of view (degrees).
    Perspective(T),
    /// Orthographic projection with a specified width.
    Orthographic(T),
}

impl<T: RealField + Copy> SerializedProjection<T> {
    /// Construct an `Projection` instance.
    ///
    /// # Errors
    ///
    /// Returns an error if numeric type conversion fails when converting degrees to radians.
    pub fn build(self) -> Result<Projection<T>> {
        Ok(match self {
            Self::Perspective(fov) => {
                let to_rad = T::try_from_f64(DEGREES_TO_RADIANS)?;
                Projection::Perspective(fov * to_rad)
            }
            Self::Orthographic(width) => Projection::Orthographic(width),
        })
    }
}