Struct Ray

pub struct Ray { /* private fields */ }

A ray emitted from an origin in a given direction.

The contents of the Ray structure are private, and should not be modified directly.

GLib type: Inline allocated boxed type with stack copy semantics.

Implementations

impl Ray

pub fn as_ptr(&self) -> *mut graphene_ray_t

pub unsafe fn from_glib_ptr_borrow<'a>(ptr: *const graphene_ray_t) -> &'a Self

Borrows the underlying C value.

pub unsafe fn from_glib_ptr_borrow_mut<'a>( ptr: *mut graphene_ray_t, ) -> &'a mut Self

Borrows the underlying C value mutably.

impl Ray

pub fn closest_point_to_point(&self, p: &Point3D) -> Point3D

Computes the point on the given Ray that is closest to the given point p.

p

a Point3D

Returns

res

return location for the closest point3d

pub fn direction(&self) -> Vec3

Retrieves the direction of the given Ray.

Returns

direction

return location for the direction

pub fn distance_to_plane(&self, p: &Plane) -> f32

Computes the distance of the origin of the given Ray from the given plane.

If the ray does not intersect the plane, this function returns INFINITY.

p

a Plane

Returns

the distance of the origin of the ray from the plane

pub fn distance_to_point(&self, p: &Point3D) -> f32

Computes the distance of the closest approach between the given Ray self and the point p.

The closest approach to a ray from a point is the distance between the point and the projection of the point on the ray itself.

p

a Point3D

Returns

the distance of the point

pub fn origin(&self) -> Point3D

Retrieves the origin of the given Ray.

Returns

origin

return location for the origin

pub fn position_at(&self, t: f32) -> Point3D

Retrieves the coordinates of a point at the distance t along the given Ray.

t

the distance along the ray

Returns

position

return location for the position

pub fn intersect_box(&self, b: &Box) -> (RayIntersectionKind, f32)

Intersects the given Ray self with the given Box b.

b

a Box

Returns

the type of intersection

t_out

the distance of the point on the ray that intersects the box

pub fn intersect_sphere(&self, s: &Sphere) -> (RayIntersectionKind, f32)

Intersects the given Ray self with the given Sphere s.

s

a Sphere

Returns

the type of intersection

t_out

the distance of the point on the ray that intersects the sphere

pub fn intersect_triangle(&self, t: &Triangle) -> (RayIntersectionKind, f32)

Intersects the given Ray self with the given Triangle t.

t

a Triangle

Returns

the type of intersection

t_out

the distance of the point on the ray that intersects the triangle

pub fn intersects_box(&self, b: &Box) -> bool

Checks whether the given Ray self intersects the given Box b.

See also: intersect_box()

b

a Box

Returns

true if the ray intersects the box

pub fn intersects_sphere(&self, s: &Sphere) -> bool

Checks if the given Ray self intersects the given Sphere s.

See also: intersect_sphere()

s

a Sphere

Returns

true if the ray intersects the sphere

pub fn intersects_triangle(&self, t: &Triangle) -> bool

Checks whether the given Ray self intersects the given Triangle b.

See also: intersect_triangle()

t

a Triangle

Returns

true if the ray intersects the triangle

impl Ray

pub fn new(origin: Option<&Point3D>, direction: Option<&Vec3>) -> Self

Initializes the given Ray using the given origin and direction values.

origin

the origin of the ray

direction

the direction vector

Returns

the initialized ray

pub fn from_vec3(origin: Option<&Vec3>, direction: Option<&Vec3>) -> Self

Initializes the given Ray using the given vectors.

origin

a Vec3

direction

a Vec3

Returns

the initialized ray

Trait Implementations

impl Clone for Ray

fn clone(&self) -> Self

Copies the inline boxed type by value with the type-specific copy function.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Ray

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for Ray

type ParamSpec = ParamSpecBoxed

type SetValue = Ray

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecBoxedBuilder<'_, Ray>

fn param_spec_builder() -> Self::BuilderFn

impl PartialEq for Ray

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StaticType for Ray

fn static_type() -> Type

Returns the type identifier of Self.

impl Copy for Ray

impl Eq for Ray