Class AABB

Creates a new AABB instance in vanilla (uninitialized) state.

The AABB is initially in "vanilla" state with invalid bounds until positions are added or bounds are explicitly set.

Gets the center point of the bounding box.

The center point is calculated as the midpoint between the minimum and maximum points. This value is cached and only recalculated when the bounds change.

Example

const aabb = new AABB();
aabb.minPoint = Vector3.fromValues(0, 0, 0);
aabb.maxPoint = Vector3.fromValues(4, 6, 8);
console.log(aabb.centerPoint); // Vector3(2, 3, 4)
Copy

Gets the distance from the center point to any corner of the bounding box.

This represents the radius of a sphere that would completely contain the AABB when centered at the AABB's center point. Useful for sphere-based culling operations.

Example

const aabb = new AABB();
aabb.minPoint = Vector3.fromValues(-1, -1, -1);
aabb.maxPoint = Vector3.fromValues(1, 1, 1);
console.log(aabb.lengthCenterToCorner); // sqrt(3) ≈ 1.732
Copy

Gets the maximum point of the bounding box.

Sets the maximum point of the bounding box.

Setting the maximum point will invalidate cached values and mark the AABB as non-vanilla.

Gets the minimum point of the bounding box.

Sets the minimum point of the bounding box.

Setting the minimum point will invalidate cached values and mark the AABB as non-vanilla.

Gets the width of the bounding box along the X-axis.

Example

const aabb = new AABB();
aabb.minPoint = Vector3.fromValues(1, 0, 0);
aabb.maxPoint = Vector3.fromValues(5, 0, 0);
console.log(aabb.sizeX); // 4
Copy

Gets the height of the bounding box along the Y-axis.

Example

const aabb = new AABB();
aabb.minPoint = Vector3.fromValues(0, 2, 0);
aabb.maxPoint = Vector3.fromValues(0, 8, 0);
console.log(aabb.sizeY); // 6
Copy

Gets the depth of the bounding box along the Z-axis.

Example

const aabb = new AABB();
aabb.minPoint = Vector3.fromValues(0, 0, -2);
aabb.maxPoint = Vector3.fromValues(0, 0, 3);
console.log(aabb.sizeZ); // 5
Copy

Expands the AABB to include the given position.

If this is the first position added to a vanilla AABB, it will set both min and max points to this position. Otherwise, it will expand the bounds as necessary to encompass the new position.

Example

const aabb = new AABB();
aabb.addPosition(Vector3.fromValues(1, 2, 3));
aabb.addPosition(Vector3.fromValues(4, 1, 2));
// AABB now encompasses both points
Copy

Expands the AABB to include a position from an array at the specified index.

This is a more efficient way to add positions when working with packed vertex data or other array-based position representations.

Example

const positions = [1, 2, 3, 4, 5, 6]; // Two 3D positions
const aabb = new AABB();
aabb.addPositionWithArray(positions, 0); // Add position (1, 2, 3)
aabb.addPositionWithArray(positions, 3); // Add position (4, 5, 6)
Copy

Creates a deep copy of this AABB instance.

All internal state including bounds, cached values, and dirty flags are copied to the new instance.

Example

const originalAABB = new AABB();
originalAABB.addPosition(Vector3.fromValues(1, 1, 1));
const clonedAABB = originalAABB.clone();
Copy

Copies all components and state from another AABB into this instance.

This is a more efficient alternative to creating a new instance when you want to overwrite the current AABB's state.

Example

const sourceAABB = new AABB();
const targetAABB = new AABB();
targetAABB.copyComponents(sourceAABB);
Copy

Resets this AABB to its initial vanilla state.

Clears all bounds, cached values, and marks the AABB as vanilla. After initialization, the AABB will need new positions added to become valid.

Example

const aabb = new AABB();
aabb.addPosition(Vector3.fromValues(1, 1, 1));
aabb.initialize(); // Reset to vanilla state
console.log(aabb.isVanilla()); // true
Copy

Checks whether this AABB is in vanilla (uninitialized) state.

A vanilla AABB has not had any positions added and contains invalid bounds. Most operations on vanilla AABBs will return early or produce undefined results.

Example

const aabb = new AABB();
console.log(aabb.isVanilla()); // true
aabb.addPosition(Vector3.fromValues(1, 1, 1));
console.log(aabb.isVanilla()); // false
Copy

Merges this AABB with another AABB to create a combined bounding volume.

The resulting AABB will encompass both the original and the merged AABB. If either AABB is vanilla, special handling is applied.

Example

const aabb1 = new AABB();
const aabb2 = new AABB();
aabb1.addPosition(Vector3.fromValues(0, 0, 0));
aabb2.addPosition(Vector3.fromValues(5, 5, 5));
aabb1.mergeAABB(aabb2); // aabb1 now encompasses both volumes
Copy

Returns a string representation of the AABB with full precision.

Includes minimum and maximum points, center point, and center-to-corner distance.

Example

const aabb = new AABB();
aabb.addPosition(Vector3.fromValues(1, 2, 3));
console.log(aabb.toString());
// Output: "AABB_min: (1, 2, 3)\nAABB_max: (1, 2, 3)\n..."
Copy

Returns a string representation of the AABB with rounded numbers for readability.

Similar to toString() but with approximate values that are easier to read. Useful for debugging and logging where exact precision is not required.

Example

const aabb = new AABB();
aabb.addPosition(Vector3.fromValues(1.23456789, 2.3456789, 3.456789));
console.log(aabb.toStringApproximately());
// Output with rounded values for better readability
Copy

Transforms an AABB by a matrix and stores the result in an output AABB.

This method transforms all 8 corners of the input AABB using the given matrix, then calculates the axis-aligned bounding box that encompasses all transformed corners. This is necessary because matrix transformations can rotate the AABB, requiring recalculation of the axis-aligned bounds.

Example

const matrix = Matrix44.rotateY(Math.PI / 4); // 45-degree rotation
const sourceAABB = new AABB();
const resultAABB = new AABB();
sourceAABB.addPosition(Vector3.fromValues(1, 1, 1));
AABB.multiplyMatrixTo(matrix, sourceAABB, resultAABB);
Copy