graphene/
ray.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
// 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, Ray, Vec3};

impl Ray {
    /// Initializes the given [`Ray`][crate::Ray] using the given `origin`
    /// and `direction` values.
    /// ## `origin`
    /// the origin of the ray
    /// ## `direction`
    /// the direction vector
    ///
    /// # Returns
    ///
    /// the initialized ray
    #[doc(alias = "graphene_ray_init")]
    pub fn new(origin: Option<&Point3D>, direction: Option<&Vec3>) -> Self {
        assert_initialized_main_thread!();
        unsafe {
            let mut ray = Self::uninitialized();
            ffi::graphene_ray_init(
                ray.to_glib_none_mut().0,
                origin.to_glib_none().0,
                direction.to_glib_none().0,
            );
            ray
        }
    }

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

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