graphene/
sphere.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
101
102
// 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, Sphere, Vec3};

impl Sphere {
    /// Initializes the given [`Sphere`][crate::Sphere] with the given `center` and `radius`.
    /// ## `center`
    /// the coordinates of the center of the sphere, or [`None`]
    ///  for a center in (0, 0, 0)
    /// ## `radius`
    /// the radius of the sphere
    ///
    /// # Returns
    ///
    /// the initialized [`Sphere`][crate::Sphere]
    #[doc(alias = "graphene_sphere_init")]
    pub fn new(center: Option<&Point3D>, radius: f32) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut sph = Self::uninitialized();
            ffi::graphene_sphere_init(sph.to_glib_none_mut().0, center.to_glib_none().0, radius);
            sph
        }
    }

    /// Initializes the given [`Sphere`][crate::Sphere] using the given array
    /// of 3D coordinates so that the sphere includes them.
    ///
    /// The center of the sphere can either be specified, or will be center
    /// of the 3D volume that encompasses all `points`.
    /// ## `points`
    /// an array of [`Point3D`][crate::Point3D]
    /// ## `center`
    /// the center of the sphere
    ///
    /// # Returns
    ///
    /// the initialized [`Sphere`][crate::Sphere]
    #[doc(alias = "graphene_sphere_init_from_points")]
    #[doc(alias = "init_from_points")]
    pub fn from_points(points: &[Point3D], center: Option<&Point3D>) -> Self {
        assert_initialized_main_thread!();

        let n = points.len() as u32;

        unsafe {
            let mut sph = Self::uninitialized();
            ffi::graphene_sphere_init_from_points(
                sph.to_glib_none_mut().0,
                n,
                points.to_glib_none().0,
                center.to_glib_none().0,
            );
            sph
        }
    }

    /// Initializes the given [`Sphere`][crate::Sphere] using the given array
    /// of 3D coordinates so that the sphere includes them.
    ///
    /// The center of the sphere can either be specified, or will be center
    /// of the 3D volume that encompasses all `vectors`.
    /// ## `vectors`
    /// an array of [`Vec3`][crate::Vec3]
    /// ## `center`
    /// the center of the sphere
    ///
    /// # Returns
    ///
    /// the initialized [`Sphere`][crate::Sphere]
    #[doc(alias = "graphene_sphere_init_from_vectors")]
    #[doc(alias = "init_from_vectors")]
    pub fn from_vectors(vectors: &[Vec3], center: Option<&Point3D>) -> Self {
        assert_initialized_main_thread!();

        let n = vectors.len() as u32;

        unsafe {
            let mut sph = Self::uninitialized();
            ffi::graphene_sphere_init_from_vectors(
                sph.to_glib_none_mut().0,
                n,
                vectors.to_glib_none().0,
                center.to_glib_none().0,
            );
            sph
        }
    }
}

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