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::{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()
}
}