Struct Ray 

pub struct Ray {
    pub origin: Vector3D,
    pub direction: Vector3D,
    pub t_min: f64,
    pub t_max: f64,
    pub depth: u32,
}

A 3D ray carrying the parameters needed for traversal and depth tracking.

Fields

origin: Vector3D

The world-space origin of the ray.

direction: Vector3D

The unit direction of the ray.

t_min: f64

The minimum acceptable t value for valid intersections.

t_max: f64

The maximum t value before the ray escapes the scene.

depth: u32

The current recursion depth (used to terminate recursive bounces).

Implementations

impl Ray

Implements factory constructors and accessors for Ray and Occluder.

pub fn new(origin: Vector3D, direction: Vector3D) -> Ray

Creates a new ray starting at origin pointing in direction.

t_min and t_max default to [RAYTRACE_DEFAULT_T_MIN] and [RAYTRACE_DEFAULT_T_MAX]. depth defaults to 0.

Arguments

• Vector3D - The ray origin.
• Vector3D - The unit direction.

Returns

• Ray - The new ray.

pub fn at(&self, t: f64) -> Vector3D

Computes the world-space point at distance t along this ray.

Arguments

• f64 - The ray parameter.

Returns

• Vector3D - origin + direction * t.

pub fn with_depth(&self, depth: u32) -> Ray

Returns a clone of this ray with depth replaced by depth.

Arguments

• u32 - The new recursion depth.

Returns

• Ray - The cloned ray with updated depth.

pub fn with_range(&self, t_min: f64, t_max: f64) -> Ray

Returns a clone of this ray with its parameter range replaced.

The new bounds are taken as given, so an inverted or non-finite range is representable; both query entry points reject such a ray as untraceable rather than letting NaN comparisons decide the outcome.

Arguments

• f64 - The minimum accepted hit parameter.
• f64 - The maximum accepted hit parameter.

Returns

• Ray - The cloned ray with the new range.

pub fn intersect_triangle( &self, vertices: [Vector3D; 3], ) -> Option<(f64, Vector3D)>

Intersects this ray with a triangle using the Moller-Trumbore algorithm, keeping only hits inside this ray’s t_min..=t_max range.

The test is two-sided: a hit from either face counts, and the returned normal always faces against the ray direction. This is the range-clamped counterpart of the free intersect_triangle, which reports the raw distance however far away the triangle is.

Arguments

• [Vector3D; 3] - The three triangle vertices in winding order.

Returns

• Option<(f64, Vector3D)> - The hit distance along the ray and the unit normal oriented against the ray direction, or None on miss.

impl Ray

pub fn get_origin(&self) -> Vector3D

pub fn get_direction(&self) -> Vector3D

pub fn set_direction(&mut self, val: Vector3D) -> &mut Self

pub fn get_t_min(&self) -> f64

pub fn get_t_max(&self) -> f64

pub fn get_depth(&self) -> u32

Trait Implementations

impl Clone for Ray

fn clone(&self) -> Self

Returns a duplicate of the value.

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 PartialEq for Ray

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Ray