com.aspose.threed

Class BoundingBox

java.lang.Object

com.aspose.threed.BoundingBox

All Implemented Interfaces:

Struct<BoundingBox>, java.io.Serializable, java.lang.Cloneable

public final class BoundingBox
extends java.lang.Object
implements Struct<BoundingBox>, java.io.Serializable

The axis-aligned bounding box Example: The following code shows how to get a bounding box from an Entity instance.

      var sphere = new Sphere();
      var boundingBox = sphere.getBoundingBox();
      System.out.println("Bounding box = " + boundingBox);
 

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
BoundingBox()
BoundingBox(double minX, double minY, double minZ, double maxX, double maxY, double maxZ) Initialize a finite bounding box with given minimum and maximum corner
BoundingBox(FVector3 minimum, FVector3 maximum) Initialize a finite bounding box with given minimum and maximum corner
BoundingBox(Vector3 minimum, Vector3 maximum) Initialize a finite bounding box with given minimum and maximum corner

Method Summary

Modifier and Type	Method and Description
BoundingBox	clone() Clone current instance
boolean	contains(BoundingBox bbox) The bounding box to check if it's inside current bounding box.
boolean	contains(Vector3 p) Check if the point p is inside the bounding box
void	copyFrom(BoundingBox src) Copy internal state from argument t
boolean	equals(java.lang.Object obj) Determines if two objects are equal
static BoundingBox	fromGeometry(Geometry geometry) Construct a bounding box from given geometry
Vector3	getCenter() The center of the bounding box.
BoundingBoxExtent	getExtent() Gets the extent of the bounding box.
static BoundingBox	getInfinite() The infinite bounding box
Vector3	getMaximum() The maximum corner of the bounding box
Vector3	getMinimum() The minimum corner of the bounding box
static BoundingBox	getNull() The null bounding box
Vector3	getSize() The size of the bounding box
int	hashCode() Returns the hash code for this instance
void	merge(BoundingBox bb) Merges the new box into the current bounding box.
void	merge(double x, double y, double z) Merge current bounding box with given point
void	merge(FVector3 pt) Merge current bounding box with given point
void	merge(Vector3 pt) Merge current bounding box with given point
void	merge(Vector4 pt) Merge current bounding box with given point
static BoundingBox	mul(BoundingBox bbox, Matrix4 mat) Operator overloading for multiply, new bounding box's minimum and maximum corner will be transformed by the matrix.
boolean	overlapsWith(BoundingBox box) Check if current bounding box overlaps with specified bounding box.
double	scale() Calculates the absolute largest coordinate value of any contained point.
java.lang.String	toString() Gets the string representation of the bounding box.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.aspose.threed.Struct

byVal

Constructor Detail

BoundingBox

public BoundingBox(Vector3 minimum,
                   Vector3 maximum)

Initialize a finite bounding box with given minimum and maximum corner

Parameters:

minimum - The minimum corner

maximum - The maximum corner Example: The following code shows how to construct a bounding box from minimum and maximum corners.

  var minimum = new Vector3(0, 0, 0);
  var maximum = new Vector3(10, 10, 10);
  var boundingBox = new BoundingBox(minimum, maximum);
  System.out.println("Bounding box = " + boundingBox);
 

BoundingBox

public BoundingBox(FVector3 minimum,
                   FVector3 maximum)

Initialize a finite bounding box with given minimum and maximum corner

Parameters:

minimum - The minimum corner

maximum - The maximum corner Example: The following code shows how to construct a bounding box from minimum and maximum corners.

  var minimum = new Vector3(0, 0, 0);
  var maximum = new Vector3(10, 10, 10);
  var boundingBox = new BoundingBox(minimum, maximum);
  System.out.println("Bounding box = " + boundingBox);
 

BoundingBox

public BoundingBox(double minX,
                   double minY,
                   double minZ,
                   double maxX,
                   double maxY,
                   double maxZ)

Initialize a finite bounding box with given minimum and maximum corner

Parameters:

minX - The minimum corner's X

minY - The minimum corner's Y

minZ - The minimum corner's Z

maxX - The maximum corner's X

maxY - The maximum corner's Y

maxZ - The maximum corner's Z Example: The following code shows how to construct a bounding box from minimum and maximum corners.

  var boundingBox = new BoundingBox(0, 0, 0, 10, 10, 10);
  System.out.println("Bounding box = " + boundingBox);
 

BoundingBox

public BoundingBox()

Method Detail

getNull

public static BoundingBox getNull()

The null bounding box

Returns:

The null bounding box

getInfinite

public static BoundingBox getInfinite()

The infinite bounding box

Returns:

The infinite bounding box

getExtent

public BoundingBoxExtent getExtent()

Gets the extent of the bounding box.

Returns:

the extent of the bounding box.

getMinimum

public Vector3 getMinimum()

The minimum corner of the bounding box

Returns:

The minimum corner of the bounding box

getMaximum

public Vector3 getMaximum()

The maximum corner of the bounding box

Returns:

The maximum corner of the bounding box

scale

public double scale()

Calculates the absolute largest coordinate value of any contained point.

Returns:

the calculated absolute largest coordinate value of any contained point.

getSize

public Vector3 getSize()

The size of the bounding box

Returns:

The size of the bounding box

getCenter

public Vector3 getCenter()

The center of the bounding box.

Returns:

The center of the bounding box.

fromGeometry

public static BoundingBox fromGeometry(Geometry geometry)

Construct a bounding box from given geometry

Parameters:

geometry - The geometry to calculate bounding box

Returns:

The bounding box of given geometry Example: The following code shows how to construct a bounding box from a geometry instance.

  var sphere = (new Sphere()).toMesh();
  var boundingBox = BoundingBox.fromGeometry(sphere);
  System.out.println("Bounding box = " + boundingBox);
 

merge

public void merge(Vector4 pt)

Merge current bounding box with given point

Parameters:

pt - The point to be merged into the bounding box Example: The following code shows how to merge a point to bounding box.

  var boundingBox = BoundingBox.getNull();
  boundingBox.Merge(new Vector4(1, 10, -1));
  System.out.println("Bounding box = " + boundingBox);
 

merge

public void merge(Vector3 pt)

Merge current bounding box with given point

Parameters:

pt - The point to be merged into the bounding box Example: The following code shows how to merge a point to bounding box.

  var boundingBox = BoundingBox.getNull();
  boundingBox.Merge(new Vector3(1, 10, -1));
  System.out.println("Bounding box = " + boundingBox);
 

merge

public void merge(FVector3 pt)

Merge current bounding box with given point

Parameters:

pt - The point to be merged into the bounding box Example: The following code shows how to merge a point to bounding box.

  var boundingBox = BoundingBox.getNull();
  boundingBox.Merge(new Vector3(1, 10, -1));
  System.out.println("Bounding box = " + boundingBox);
 

merge

public void merge(double x,
                  double y,
                  double z)

Merge current bounding box with given point

Parameters:

x - The point to be merged into the bounding box

y - The point to be merged into the bounding box

z - The point to be merged into the bounding box Example: The following code shows how to merge a point to bounding box.

  var boundingBox = BoundingBox.getNull();
  boundingBox.Merge(1, 10, -1);
  System.out.println("Bounding box = " + boundingBox);
 

merge

public void merge(BoundingBox bb)

Merges the new box into the current bounding box.

Parameters:

bb - The bounding box to merge

mul

public static BoundingBox mul(BoundingBox bbox,
                              Matrix4 mat)

Operator overloading for multiply, new bounding box's minimum and maximum corner will be transformed by the matrix.

Parameters:

bbox - The input bounding box.

mat - The matrix used to transform the bounding box's corners

Returns:

The product of bounding box and transform matrix.

toString

public java.lang.String toString()

Gets the string representation of the bounding box.

Overrides:

toString in class java.lang.Object

Returns:

The string representation of the bounding box.

equals

public boolean equals(java.lang.Object obj)

Determines if two objects are equal

Overrides:

equals in class java.lang.Object

Parameters:

obj - The object to compare

Returns:

true if two objects are equal

overlapsWith

public boolean overlapsWith(BoundingBox box)

Check if current bounding box overlaps with specified bounding box.

Parameters:

box - The other bounding box to test

Returns:

True if the current bounding box overlaps with the given one. Example: The following code shows how to check if two bounding boxes overlaps with each other.

  var boundingBox = new BoundingBox(0, 0, 0, 10, 10, 10);
  var bbox2 = new BoundingBox(1, 1, 1, 11, 11, 11);
  System.out.println("Bounding box overlaps = " + boundingBox.overlapsWith(bbox2));
 

contains

public boolean contains(Vector3 p)

Check if the point p is inside the bounding box

Parameters:

p - The point to test

Returns:

True if the point is inside the bounding box Example: The following code shows how to check if a point is inside the bounding box.

  var boundingBox = new BoundingBox(0, 0, 0, 10, 10, 10);
  var pt = new Vector3(4, 4, 4);
  System.out.println("Bounding box overlaps = " + boundingBox.contains(pt));
 

contains

public boolean contains(BoundingBox bbox)

The bounding box to check if it's inside current bounding box.

clone

public BoundingBox clone()

Description copied from interface: Struct

Clone current instance

Specified by:

clone in interface Struct<BoundingBox>

Overrides:

clone in class java.lang.Object

Returns:

cloned instance

copyFrom

public void copyFrom(BoundingBox src)

Description copied from interface: Struct

Copy internal state from argument t

Specified by:

copyFrom in interface Struct<BoundingBox>

Parameters:

src - source instance to copy

hashCode

public int hashCode()

Returns the hash code for this instance

Overrides:

hashCode in class java.lang.Object

Returns:

The hash code of the bounding box