graphene/
vec3.rs

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
// Take a look at the license at the top of the repository in the LICENSE file.

use std::fmt;

use glib::translate::*;

use crate::{ffi, Vec3};

impl Vec3 {
    /// Initializes a [`Vec3`][crate::Vec3] using the given values.
    ///
    /// This function can be called multiple times.
    /// ## `x`
    /// the X field of the vector
    /// ## `y`
    /// the Y field of the vector
    /// ## `z`
    /// the Z field of the vector
    ///
    /// # Returns
    ///
    /// a pointer to the initialized
    ///  vector
    #[doc(alias = "graphene_vec3_init")]
    pub fn new(x: f32, y: f32, z: f32) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut vec = Self::uninitialized();
            ffi::graphene_vec3_init(vec.to_glib_none_mut().0, x, y, z);
            vec
        }
    }

    /// Initializes a [`Vec3`][crate::Vec3] with the values from an array.
    /// ## `src`
    /// an array of 3 floating point values
    ///
    /// # Returns
    ///
    /// the initialized vector
    #[doc(alias = "graphene_vec3_init_from_float")]
    #[doc(alias = "init_from_float")]
    pub fn from_float(src: [f32; 3]) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut vec = Self::uninitialized();
            ffi::graphene_vec3_init_from_float(vec.to_glib_none_mut().0, src.as_ptr() as *const _);
            vec
        }
    }

    /// Copies the components of a [`Vec3`][crate::Vec3] into the given array.
    ///
    /// # Returns
    ///
    ///
    /// ## `dest`
    /// return location for
    ///  an array of floating point values
    #[doc(alias = "graphene_vec3_to_float")]
    pub fn to_float(&self) -> [f32; 3] {
        unsafe {
            let mut out = std::mem::MaybeUninit::uninit();
            ffi::graphene_vec3_to_float(self.to_glib_none().0, out.as_mut_ptr());
            out.assume_init()
        }
    }
}

impl fmt::Debug for Vec3 {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("Vec3")
            .field("x", &self.x())
            .field("y", &self.y())
            .field("z", &self.z())
            .finish()
    }
}

impl Default for Vec3 {
    fn default() -> Self {
        Self::zero()
    }
}