curvo 0.1.88

NURBS modeling library
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

use nalgebra::{IsometryMatrix3, Point3, Rotation3, Translation3, Vector3};
use simba::scalar::SupersetOf;

use crate::misc::FloatingPoint;

/// A Frenet frame at a point on a curve.
#[derive(Debug, Clone)]
pub struct FrenetFrame<T: FloatingPoint> {
    position: Point3<T>,
    tangent: Vector3<T>,
    normal: Vector3<T>,
    binormal: Vector3<T>,
}

impl<T: FloatingPoint> FrenetFrame<T> {
    pub fn new(
        position: Point3<T>,
        tangent: Vector3<T>,
        normal: Vector3<T>,
        binormal: Vector3<T>,
    ) -> Self {
        Self {
            position,
            tangent,
            normal,
            binormal,
        }
    }

    pub fn position(&self) -> &Point3<T> {
        &self.position
    }

    pub fn tangent(&self) -> &Vector3<T> {
        &self.tangent
    }

    pub fn normal(&self) -> &Vector3<T> {
        &self.normal
    }

    pub fn binormal(&self) -> &Vector3<T> {
        &self.binormal
    }

    /// Returns the rotation matrix that transforms a target to the frame coordinates.
    pub fn rotation(&self) -> Rotation3<T> {
        Rotation3::face_towards(&self.tangent, &self.normal)
    }

    /// Returns the transformation matrix that transforms a target to the frame coordinates.
    pub fn matrix(&self) -> IsometryMatrix3<T> {
        let trans = Translation3::from(self.position);
        let rot = self.rotation();
        trans * rot
    }

    /// Casts the Frenet frame to another floating point type.
    pub fn cast<F: FloatingPoint + SupersetOf<T>>(&self) -> FrenetFrame<F> {
        FrenetFrame {
            position: self.position.cast(),
            tangent: self.tangent.cast(),
            normal: self.normal.cast(),
            binormal: self.binormal.cast(),
        }
    }
}