Struct Aabb 

pub struct Aabb {
    pub min: Vec3A,
    pub max: Vec3A,
}

Axis-Aligned Bounding Box (AABB) represented by min/max corners.

Uses Vec3A (16-byte aligned SIMD vector) for performance. An “empty” AABB has min = +INF, max = -INF and represents no volume.

Fields

min: Vec3A

max: Vec3A

Implementations

impl Aabb

pub fn new(min: impl Into<Vec3A>, max: impl Into<Vec3A>) -> Aabb

Creates an AABB from explicit min/max corners. Caller is responsible for ensuring min <= max on all axes.

pub fn empty() -> Aabb

Creates the canonical empty/invalid AABB (min = +INF, max = -INF).

pub fn from_center_half_extents( center: impl Into<Vec3A>, half_extents: impl Into<Vec3A>, ) -> Aabb

Creates an AABB from a center point and half-extents.

pub fn from_points(points: impl IntoIterator<Item = impl Into<Vec3A>>) -> Aabb

Creates an AABB that contains all the provided points. Returns Aabb::empty() if the iterator is empty.

pub fn is_empty(self) -> bool

Returns true if the AABB has no valid volume and is strictly invalid (min > max on any axis). Note: A degenerate point where min == max is NOT considered empty. This is a deliberate design choice so zero-volume points can still overlap with frustums or other shapes. To check for zero volume, use is_degenerate().

pub fn is_degenerate(self) -> bool

Returns true if the AABB has zero volume (min >= max on any axis). This includes both strictly empty AABBs and degenerate points, lines, or planes.

pub fn is_valid(self) -> bool

Returns true if the AABB has a valid volume.

pub fn center(self) -> Vec3A

Returns the center of the AABB.

pub fn half_extents(self) -> Vec3A

Returns the half-extents (half the size on each axis).

pub fn size(self) -> Vec3A

Returns the full size (extent) on each axis.

pub fn volume(self) -> f32

Returns the total volume of the AABB. Returns 0.0 for an empty AABB.

pub fn surface_area(self) -> f32

Returns the surface area of the AABB. Useful for SAH-based BVH construction. Returns 0.0 for an empty AABB.

pub fn diagonal(self) -> f32

Returns the length of the diagonal of the AABB.

pub fn contains_point(self, pt: impl Into<Vec3A>) -> bool

Returns true if the point lies inside or on the boundary of this AABB.

pub fn contains_aabb(self, other: Aabb) -> bool

Returns true if other is entirely contained within this AABB.

pub fn closest_point(self, pt: impl Into<Vec3A>) -> Vec3A

Returns the closest point on (or inside) the AABB to the given point.

pub fn distance_sq_to_point(self, pt: impl Into<Vec3A>) -> f32

Returns the squared distance from the point to the AABB surface. Returns 0.0 if the point is inside the AABB.

pub fn distance_to_point(self, pt: impl Into<Vec3A>) -> f32

Returns the distance from the point to the AABB surface. Returns 0.0 if the point is inside the AABB.

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

Returns true if this AABB overlaps other. Edge/face-touching counts as intersection.

pub fn intersects_exclusive(self, other: Aabb) -> bool

Returns true if this AABB strictly overlaps other. Edge/face-touching does NOT count as intersection.

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

Returns the intersection volume as an Aabb, or None if they do not overlap. Edge/face-touching yields a degenerate AABB (zero volume on at least one axis).

pub fn extend(&mut self, pt: impl Into<Vec3A>)

Expands this AABB to include the given point.

pub fn merge(self, other: Aabb) -> Aabb

Returns a new AABB that is the union of self and other.

pub fn expand(self, amount: f32) -> Aabb

Returns a new AABB expanded (inflated) outward by amount on every face. A negative amount shrinks the AABB. If shrinking causes inversion, returns empty.

pub fn transform(self, mat: &Mat4) -> Aabb

Transforms this AABB by a Mat4, returning a new world-space AABB.

Uses Arvo’s method: applies the 3×3 rotation/scale part column-by-column, so only 3 iterations instead of 8 corner transforms.

Reference: James Arvo, “Transforming Axis-Aligned Bounding Boxes”, Graphics Gems, 1990.

pub fn corners(self) -> [Vec3A; 8]

Returns all 8 corners of the AABB in a fixed order. Order: — -+- +– ++- –+ -++ +-+ +++ (xyz sign pattern)

Trait Implementations

impl Clone for Aabb

fn clone(&self) -> Aabb

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Aabb

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

Formats the value using the given formatter.

impl Default for Aabb

fn default() -> Aabb

Returns the “default value” for a type.

impl Display for Aabb

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

Formats the value using the given formatter.

impl PartialEq for Aabb

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

impl StructuralPartialEq for Aabb