Struct AABB3 

pub struct AABB3 {
    pub min: Point3,
    pub max: Point3,
}

A 3D axis-aligned bounding box.

Invariant

min.x <= max.x, min.y <= max.y, min.z <= max.z.

Reference

Ericson (2005), “Real-Time Collision Detection”, Ch. 4.2

Fields

min: Point3

Minimum corner.

max: Point3

Maximum corner.

Implementations

impl AABB3

pub fn new( min_x: f64, min_y: f64, min_z: f64, max_x: f64, max_y: f64, max_z: f64, ) -> Self

Creates an AABB from min/max coordinates.

pub fn from_min_size(min: Point3, width: f64, depth: f64, height: f64) -> Self

Creates an AABB from min corner and dimensions.

pub fn from_points(points: &[Point3]) -> Option<Self>

Creates an AABB enclosing a set of 3D points.

Returns None if the slice is empty.

Complexity

O(n)

pub fn width(&self) -> f64

Width (x extent).

pub fn depth(&self) -> f64

Depth (y extent).

pub fn height(&self) -> f64

Height (z extent).

pub fn volume(&self) -> f64

Volume.

pub fn surface_area(&self) -> f64

Surface area.

Useful as a BVH splitting heuristic (SAH).

pub fn center(&self) -> Point3

Center point.

pub fn contains_point(&self, p: &Point3) -> bool

Whether this AABB contains a point.

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

Whether this AABB fully contains another.

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

Whether two AABBs intersect.

Complexity

O(1)

pub fn intersection(&self, other: &Self) -> Option<Self>

Returns the intersection of two AABBs, or None if they don’t overlap.

pub fn union(&self, other: &Self) -> Self

Returns the union (bounding box) of two AABBs.

pub fn expand(&self, margin: f64) -> Self

Returns a new AABB expanded by margin on all sides.

Trait Implementations

impl Clone for AABB3

fn clone(&self) -> AABB3

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AABB3

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

Formats the value using the given formatter.

impl PartialEq for AABB3

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

impl StructuralPartialEq for AABB3