Struct Cube 

pub struct Cube {
    pub x: f64,
    pub y: f64,
    pub z: f64,
    pub width: f64,
    pub height: f64,
    pub depth: f64,
}

Represents a cube (or cuboid) in 3D space.

Fields

x: f64

The x-coordinate of the cube’s top-left-front corner.

y: f64

The y-coordinate of the cube’s top-left-front corner.

z: f64

The z-coordinate of the cube’s top-left-front corner.

width: f64

The width of the cube.

height: f64

The height of the cube.

depth: f64

The depth of the cube.

Implementations

impl Cube

pub fn contains<T>(&self, point: &Point3D<T>) -> bool

Determines if the cube contains the given 3D point.

Arguments

• point - The 3D point to test.

Examples

use spart::geometry::{Cube, Point3D};
let cube = Cube { x: 0.0, y: 0.0, z: 0.0, width: 10.0, height: 10.0, depth: 10.0 };
let pt: Point3D<()> = Point3D::new(5.0, 5.0, 5.0, None);
assert!(cube.contains(&pt));

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

Determines whether this cube intersects with another cube.

Arguments

• other - The other cube.

Examples

use spart::geometry::Cube;
let a = Cube { x: 0.0, y: 0.0, z: 0.0, width: 5.0, height: 5.0, depth: 5.0 };
let b = Cube { x: 3.0, y: 3.0, z: 3.0, width: 5.0, height: 5.0, depth: 5.0 };
assert!(a.intersects(&b));

pub fn area(&self) -> f64

Computes the volume of the cube.

Examples

use spart::geometry::Cube;
let cube = Cube { x: 0.0, y: 0.0, z: 0.0, width: 2.0, height: 3.0, depth: 4.0 };
assert_eq!(cube.area(), 24.0);

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

Computes the union of this cube with another.

The union is defined as the smallest cube that completely contains both cubes.

Arguments

• other - The other cube.

Examples

use spart::geometry::Cube;
let a = Cube { x: 0.0, y: 0.0, z: 0.0, width: 3.0, height: 3.0, depth: 3.0 };
let b = Cube { x: 2.0, y: 2.0, z: 2.0, width: 3.0, height: 3.0, depth: 3.0 };
let union_cube = a.union(&b);
assert_eq!(union_cube.x, 0.0);

pub fn enlargement(&self, other: &Cube) -> f64

Computes the enlargement needed to include another cube.

The enlargement is defined as the difference between the volume of the union and the volume of this cube.

Arguments

• other - The other cube.

Examples

use spart::geometry::Cube;
let a = Cube { x: 0.0, y: 0.0, z: 0.0, width: 2.0, height: 2.0, depth: 2.0 };
let b = Cube { x: 1.0, y: 1.0, z: 1.0, width: 2.0, height: 2.0, depth: 2.0 };
let enlargement = a.enlargement(&b);
assert!(enlargement >= 0.0);

impl Cube

pub fn min_distance<T>(&self, point: &Point3D<T>) -> f64

Computes the minimum distance from this cube to a given 3D point.

Kept as an inherent method for convenience; the logic lives in HasMinDistance.

pub fn min_distance_sq<T>(&self, point: &Point3D<T>) -> f64

Computes the squared minimum distance from this cube to a given 3D point.

Trait Implementations

impl BSPBounds for Cube

const DIM: usize = 3

The number of dimensions supported.

fn center(&self, dim: usize) -> Result<f64, SpartError>

Returns the center coordinate along the specified dimension.

fn extent(&self, dim: usize) -> Result<f64, SpartError>

Returns the extent (width, height, or depth) along the specified dimension.

impl BoundingVolume for Cube

fn area(&self) -> f64

Returns the area (or volume for 3D objects) of the bounding volume.

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

Returns the smallest bounding volume that contains both self and other.

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

Determines whether the bounding volume intersects with another.

fn overlap(&self, other: &Self) -> f64

Computes the overlap between two bounding volumes

fn margin(&self) -> f64

Computes the margin of a bounding box

fn enlargement(&self, other: &Self) -> f64

Computes the enlargement required to include other in the bounding volume.

impl<T> BoundingVolumeFromPoint<Point3D<T>> for Cube

fn from_point_radius(query: &Point3D<T>, radius: f64) -> Self

Creates a bounding volume that encapsulates a point with the specified radius.

impl Clone for Cube

fn clone(&self) -> Cube

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cube

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

Formats the value using the given formatter.

impl<T> HasMinDistance<Point3D<T>> for Cube

fn min_distance(&self, point: &Point3D<T>) -> f64

Computes the minimum distance from the bounding volume to the given query.

fn min_distance_sq(&self, point: &Point3D<T>) -> f64

Computes the squared minimum distance from the bounding volume to the given query.