gfxmath-vec3 0.1.2

A simple 3D math 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

use crate::Vec3;
use crate::ops::Norm;

/// ```
/// use gfxmath_vec3::ops::Norm;
/// use gfxmath_vec3::Vec3;
/// 
/// let a = Vec3::<f32>::new(3.0, 4.0, 0.0);
/// let an = a.norm().unwrap();
/// 
/// assert_eq!(3.0/5.0, an.x);
/// assert_eq!(4.0/5.0, an.y);
/// assert_eq!(0.0, an.z);
/// ```
#[opimps::impl_uni_ops(Norm)]
#[inline]
fn norm(self: Vec3<f32>) -> Option<Vec3<f32>> {
    let l = self.as_slice();

    let len = l[0] * l[0]
         + l[1] * l[1]
         + l[2] * l[2];
    
    let len = len.sqrt();
    if len == 0.0 { return None; }

    Some(
        Vec3::new(
        l[0]/len,
        l[1]/len,
        l[2]/len
        )
    )
}

/// ```
/// use gfxmath_vec3::ops::Norm;
/// use gfxmath_vec3::Vec3;
/// 
/// let a = Vec3::<f64>::new(3.0, 4.0, 0.0);
/// let an = a.norm().unwrap();
/// 
/// assert_eq!(3.0/5.0, an.x);
/// assert_eq!(4.0/5.0, an.y);
/// assert_eq!(0.0, an.z);
/// ```
#[opimps::impl_uni_ops(Norm)]
fn norm(self: Vec3<f64>) -> Option<Vec3<f64>> {
    let l = self.as_slice();

    let len = l[0] * l[0]
         + l[1] * l[1]
         + l[2] * l[2];
    
    let len = len.sqrt();
    if len == 0.0 { return None; }

    Some(
        Vec3::new(
        l[0]/len,
        l[1]/len,
        l[2]/len
        )
    )
}