graphene/
triangle.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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
// 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, Point3D, Triangle, Vec3};

impl Triangle {
    /// Initializes a [`Triangle`][crate::Triangle] using the three given arrays
    /// of floating point values, each representing the coordinates of
    /// a point in 3D space.
    /// ## `a`
    /// an array of 3 floating point values
    /// ## `b`
    /// an array of 3 floating point values
    /// ## `c`
    /// an array of 3 floating point values
    ///
    /// # Returns
    ///
    /// the initialized [`Triangle`][crate::Triangle]
    #[doc(alias = "graphene_triangle_init_from_float")]
    #[doc(alias = "init_from_float")]
    pub fn from_float(a: [f32; 3], b: [f32; 3], c: [f32; 3]) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut tri = Self::uninitialized();
            ffi::graphene_triangle_init_from_float(
                tri.to_glib_none_mut().0,
                a.as_ptr() as *const _,
                b.as_ptr() as *const _,
                c.as_ptr() as *const _,
            );
            tri
        }
    }

    /// Initializes a [`Triangle`][crate::Triangle] using the three given 3D points.
    /// ## `a`
    /// a [`Point3D`][crate::Point3D]
    /// ## `b`
    /// a [`Point3D`][crate::Point3D]
    /// ## `c`
    /// a [`Point3D`][crate::Point3D]
    ///
    /// # Returns
    ///
    /// the initialized [`Triangle`][crate::Triangle]
    #[doc(alias = "graphene_triangle_init_from_point3d")]
    #[doc(alias = "init_from_point3d")]
    pub fn from_point3d(a: Option<&Point3D>, b: Option<&Point3D>, c: Option<&Point3D>) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut tri = Self::uninitialized();
            ffi::graphene_triangle_init_from_point3d(
                tri.to_glib_none_mut().0,
                a.to_glib_none().0,
                b.to_glib_none().0,
                c.to_glib_none().0,
            );
            tri
        }
    }

    /// Initializes a [`Triangle`][crate::Triangle] using the three given vectors.
    /// ## `a`
    /// a [`Vec3`][crate::Vec3]
    /// ## `b`
    /// a [`Vec3`][crate::Vec3]
    /// ## `c`
    /// a [`Vec3`][crate::Vec3]
    ///
    /// # Returns
    ///
    /// the initialized [`Triangle`][crate::Triangle]
    #[doc(alias = "graphene_triangle_init_from_vec3")]
    #[doc(alias = "init_from_vec3")]
    pub fn from_vec3(a: Option<&Vec3>, b: Option<&Vec3>, c: Option<&Vec3>) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut tri = Self::uninitialized();
            ffi::graphene_triangle_init_from_vec3(
                tri.to_glib_none_mut().0,
                a.to_glib_none().0,
                b.to_glib_none().0,
                c.to_glib_none().0,
            );
            tri
        }
    }
}

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