dolly 0.6.0

Composable camera rigs
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use core::fmt::Debug;
use glam::{Quat, Vec3};
use std::marker::PhantomData;

use crate::handedness::Handedness;

/// A thin wrapper over a `Point3<f32>` and a `Quaternion<f32>`
#[derive(Clone, Copy, Debug)]
pub struct Transform<H: Handedness> {
    pub position: mint::Point3<f32>,
    pub rotation: mint::Quaternion<f32>,
    pub phantom: PhantomData<H>,
}

impl<H: Handedness> Transform<H> {
    pub fn from_position_rotation<P, Q>(position: P, rotation: Q) -> Self
    where
        P: Into<mint::Point3<f32>>,
        Q: Into<mint::Quaternion<f32>>,
    {
        let position = position.into();
        let rotation = rotation.into();

        Self {
            position,
            rotation,
            phantom: PhantomData,
        }
    }

    pub fn into_position_rotation<P, Q>(self) -> (P, Q)
    where
        P: From<mint::Point3<f32>>,
        Q: From<mint::Quaternion<f32>>,
    {
        (From::from(self.position), From::from(self.rotation))
    }

    /// +X
    pub fn right<V>(&self) -> V
    where
        V: From<mint::Vector3<f32>>,
    {
        let rotation: Quat = self.rotation.into();
        From::from((rotation * Vec3::X).into())
    }

    /// +Y
    pub fn up<V>(&self) -> V
    where
        V: From<mint::Vector3<f32>>,
    {
        let rotation: Quat = self.rotation.into();
        From::from((rotation * Vec3::Y).into())
    }

    /// +/-Z
    pub fn forward<V>(&self) -> V
    where
        V: From<mint::Vector3<f32>>,
    {
        let rotation: Quat = self.rotation.into();
        From::from((rotation * H::FORWARD).into())
    }

    pub const IDENTITY: Transform<H> = Transform {
        position: mint::Point3 {
            x: 0.0,
            y: 0.0,
            z: 0.0,
        },
        rotation: mint::Quaternion {
            v: mint::Vector3 {
                x: 0.0,
                y: 0.0,
                z: 0.0,
            },
            s: 1.0,
        },
        phantom: PhantomData,
    };
}