Struct Ray3D 

pub struct Ray3D {
    pub origin: Point3D,
    pub dir_x: f64,
    pub dir_y: f64,
    pub dir_z: f64,
    pub max_distance: f64,
    /* private fields */
}

Finite 3D ray segment used by raycast searches.

Example

use packed_spatial_index::{Box3D, Point3D, Ray3D};

let ray = Ray3D::new(Point3D::new(-1.0, 0.5, 0.5), 1.0, 0.0, 0.0, 10.0);
assert!(ray.intersects_box(Box3D::new(0.0, 0.0, 0.0, 1.0, 1.0, 1.0)));

Fields

origin: Point3D

Ray origin.

dir_x: f64

X component of the ray direction.

dir_y: f64

Y component of the ray direction.

dir_z: f64

Z component of the ray direction.

max_distance: f64

Maximum ray parameter to consider.

Implementations

impl Ray3D

pub const fn new( origin: Point3D, dir_x: f64, dir_y: f64, dir_z: f64, max_distance: f64, ) -> Self

Create a finite ray segment covering origin + t * dir for t in [0, max_distance].

The direction does not need to be normalized. max_distance and every returned entry t are in units of the direction length, so the Euclidean distance to a hit is t * (dir_x.hypot(dir_y).hypot(dir_z)); normalize the direction (length 1) if you want t and max_distance in world units.

A fully zero direction (dir_x == dir_y == dir_z == 0.0) is a point probe: it hits only boxes that contain origin, all at t == 0.0. Direction components should be finite; a NaN direction produces unspecified results.

pub fn intersects_box(self, bounds: Box3D) -> bool

true when the ray segment touches bounds (faces inclusive).

pub fn enter_t(self, bounds: Box3D) -> Option<f64>

Entry parameter t where the ray segment first touches bounds (0.0 if the origin is inside), or None if the segment misses. Used by ordered closest-hit traversal.

pub fn closest_triangle<T: Triangle3>( &self, triangles: &[T], ) -> Option<TriangleHit>

The closest triangle in triangles hit by this ray segment, as a TriangleHit (index into the slice and t in direction-length units), or None if the ray misses them all, by the Moller-Trumbore test.

Works over either record type: Triangle3D tests in f64, Triangle3DF32 in f32 (8 at a time with the simd feature). Pair this with a query that yields candidate triangles — an Index3DView’s triangles payload, or the items a raycast / search returns — for exact ray-mesh intersection.

Trait Implementations

impl Clone for Ray3D

fn clone(&self) -> Ray3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Ray3D

impl Debug for Ray3D

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

Formats the value using the given formatter.

impl PartialEq for Ray3D

fn eq(&self, other: &Ray3D) -> 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 StructuralPartialEq for Ray3D