graphene/
frustum.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
// 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, Frustum, Matrix, Plane};

impl Frustum {
    /// Retrieves the planes that define the given [`Frustum`][crate::Frustum].
    ///
    /// # Returns
    ///
    ///
    /// ## `planes`
    /// return location for an array
    ///  of 6 [`Plane`][crate::Plane]
    #[doc(alias = "graphene_frustum_get_planes")]
    #[doc(alias = "get_planes")]
    pub fn planes(&self) -> &[Plane; 6] {
        unsafe {
            let mut out: [ffi::graphene_plane_t; 6] = std::mem::zeroed();
            ffi::graphene_frustum_get_planes(self.to_glib_none().0, &mut out as *mut _);
            &*(&out as *const [ffi::graphene_plane_t; 6] as *const [Plane; 6])
        }
    }

    /// Initializes the given [`Frustum`][crate::Frustum] using the provided
    /// clipping planes.
    /// ## `p0`
    /// a clipping plane
    /// ## `p1`
    /// a clipping plane
    /// ## `p2`
    /// a clipping plane
    /// ## `p3`
    /// a clipping plane
    /// ## `p4`
    /// a clipping plane
    /// ## `p5`
    /// a clipping plane
    ///
    /// # Returns
    ///
    /// the initialized frustum
    #[doc(alias = "graphene_frustum_init")]
    pub fn new(p0: &Plane, p1: &Plane, p2: &Plane, p3: &Plane, p4: &Plane, p5: &Plane) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut fru = Self::uninitialized();
            ffi::graphene_frustum_init(
                fru.to_glib_none_mut().0,
                p0.to_glib_none().0,
                p1.to_glib_none().0,
                p2.to_glib_none().0,
                p3.to_glib_none().0,
                p4.to_glib_none().0,
                p5.to_glib_none().0,
            );
            fru
        }
    }

    /// Initializes a [`Frustum`][crate::Frustum] using the given `matrix`.
    /// ## `matrix`
    /// a [`Matrix`][crate::Matrix]
    ///
    /// # Returns
    ///
    /// the initialized frustum
    #[doc(alias = "graphene_frustum_init_from_matrix")]
    #[doc(alias = "init_from_matrix")]
    pub fn from_matrix(matrix: &Matrix) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut fru = Self::uninitialized();
            ffi::graphene_frustum_init_from_matrix(
                fru.to_glib_none_mut().0,
                matrix.to_glib_none().0,
            );
            fru
        }
    }
}

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