Struct Aabb 

pub struct Aabb {
    pub min: [f64; 3],
    pub max: [f64; 3],
}

The axis-aligned box around a set of points: min ≤ max on every axis, both finite. A box is never empty; an empty point set has no box.

use arris_math::Aabb;

let b = Aabb::of_points(&[[0.0, 0.0, 0.0], [2.0, -1.0, 3.0]]).unwrap();
assert_eq!(b.min, [0.0, -1.0, 0.0]);
assert_eq!(b.max, [2.0, 0.0, 3.0]);
assert_eq!(b.extent(), [2.0, 1.0, 3.0]);
assert_eq!(b.center(), [1.0, -0.5, 1.5]);

Fields

min: [f64; 3]

The smallest coordinate on each axis.

max: [f64; 3]

The largest coordinate on each axis.

Implementations

impl Aabb

pub fn of_points<'a>( points: impl IntoIterator<Item = &'a [f64; 3]>, ) -> Option<Aabb>

The box around points, or None for no points.

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

The smallest box containing both.

pub fn extent(&self) -> [f64; 3]

max - min per axis.

pub fn center(&self) -> [f64; 3]

The midpoint.

pub fn diagonal(&self) -> f64

The length of the box’s diagonal: the scale of what it contains.

pub fn of_point(p: Point3) -> Aabb

The box holding one point, of zero extent.

use arris_math::{Aabb, Point3};

let b = Aabb::of_point(Point3::new(1.0, 2.0, 3.0));
assert_eq!(b.min, b.max);
assert_eq!(b.extent(), [0.0; 3]);

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

true when the two boxes share a point, touching included: the cheap reject before a face pair is intersected. Boxes that only touch on a face intersect, so a caller that needs a margin Aabb::inflated one of them by its tolerance first.

use arris_math::Aabb;

let a = Aabb { min: [0.0; 3], max: [1.0; 3] };
let touching = Aabb { min: [1.0, 0.0, 0.0], max: [2.0, 1.0, 1.0] };
let clear = Aabb { min: [1.5, 0.0, 0.0], max: [2.0, 1.0, 1.0] };
assert!(a.intersects(&touching));
assert!(!a.intersects(&clear));

pub fn inflated(&self, by: f64) -> Aabb

The box grown by by on every side; a negative by shrinks it, and never past a point — the centre holds.

use arris_math::Aabb;

let b = Aabb { min: [0.0; 3], max: [2.0; 3] };
assert_eq!(b.inflated(0.5).min, [-0.5; 3]);
assert_eq!(b.inflated(-5.0).extent(), [0.0; 3], "never past a point");

Trait Implementations

impl Clone for Aabb

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Aabb

impl Debug for Aabb

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

Formats the value using the given formatter.

impl PartialEq for Aabb

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Aabb