projective 0.3.0

The representation projective transformation
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
83
84
85
86
87
88
89
90
91
92
93
94
95

use super::*;

/// 3D projective transformations
#[doc = "# Examples"]
#[doc = "```"]
#[doc = include_str ! ("../../tests/point3d.rs")]
#[doc = "```"]
pub trait Projective3D<T>
where
    Self: Sized,
    T: Zero + One + Real,
{
    /// Transform by a 4×4 matrix.
    ///
    /// # Matrix
    ///
    /// ```math
    /// \begin{bmatrix}
    ///     m_0  & m_1  & m_2  & m_3  \\
    ///     m_4  & m_5  & m_6  & m_7  \\
    ///     m_8  & m_9  & m_10 & m_11 \\
    ///     m_12 & m_13 & m_14 & m_15 \\
    /// \end{bmatrix}
    /// ```
    fn transform(&self, m: &[&T; 16]) -> Self;
    /// Transform by a 3×3 matrix.
    fn rotate(&self, _alpha: T, _beta: T, _gamma: T) -> Self {
        todo!()
    }
    /// Transform by a 3×3 matrix.
    fn rotate_point(&self, _point: &[T; 3], _alpha: T, _beta: T, _gamma: T) -> Self {
        todo!()
    }
    /// Rotate with a line.
    #[rustfmt::skip]
    fn rotate_axis(&self, _p1: &[T; 3], _p2: &[T; 3], _alpha:T) -> Self {
        todo!()
    }
    /// Rotate with a line.
    fn rotate_axis_x(&self, alpha: T) -> Self {
        self.rotate_axis(&[T::zero(), T::zero(), T::zero()], &[T::one(), T::zero(), T::zero()], alpha)
    }
    /// Rotate with a line.
    fn rotate_axis_y(&self, alpha: T) -> Self {
        self.rotate_axis(&[T::zero(), T::zero(), T::zero()], &[T::zero(), T::one(), T::zero()], alpha)
    }
    /// Rotate with a line.
    fn rotate_axis_z(&self, alpha: T) -> Self {
        self.rotate_axis(&[T::zero(), T::zero(), T::zero()], &[T::zero(), T::zero(), T::one()], alpha)
    }
    /// Rotate with a line.
    #[rustfmt::skip]
    fn translate(&self, x: &T, y: &T, z: &T) -> Self {
        self.transform(&[
            &T::one(), &T::zero(), &T::zero(), x,
            &T::zero(), &T::one(), &T::zero(), y,
            &T::zero(), &T::zero(), &T::one(), z,
            &T::zero(), &T::zero(), &T::zero(), &T::one(),
        ])
    }
    /// Transform by length $\delta x$.
    fn translate_x(&self, x: &T) -> Self {
        self.translate(x, &T::zero(), &T::zero())
    }
    /// Transform by length $\delta y$.
    fn translate_y(&self, y: &T) -> Self {
        self.translate(&T::zero(), y, &T::zero())
    }
    /// Transform by length $\delta z$.
    fn translate_z(&self, y: &T) -> Self {
        self.translate(&T::zero(), &T::zero(), y)
    }
    /// Transform by a translation matrix.
    #[rustfmt::skip]
    fn scale(&self, x: &T, y: &T, z: &T) -> Self {
        self.transform(&[
            x, &T::zero(), &T::zero(), &T::zero(),
            &T::zero(), y, &T::zero(), &T::zero(),
            &T::zero(), &T::zero(), z, &T::zero(),
            &T::zero(), &T::zero(), &T::zero(), &T::one(),
        ])
    }
    /// Transform by a scaling matrix.
    fn scale_x(self, x: &T) -> Self {
        self.scale(x, &T::one(), &T::one())
    }
    /// Transform by a scaling matrix.
    fn scale_y(self, y: &T) -> Self {
        self.scale(&T::one(), y, &T::one())
    }
    /// Transform by a scaling matrix.
    fn scale_z(self, z: &T) -> Self {
        self.scale(&T::one(), &T::one(), z)
    }
}