Box3

An axis-aligned bounding box (AABB) in 3D space defined by min and max vectors.

Constructor

const box = new Box3(min?, max?)
// defaults: min=(+Inf,+Inf,+Inf), max=(-Inf,-Inf,-Inf) (empty)

Properties

• min, max — Vector3 bounds
• isBox3 — Type flag (true)

Methods

Setting

• set(min, max) — Set bounds
• setFromArray(array) — From flat position array
• setFromBufferAttribute(attribute) — From position buffer attribute
• setFromPoints(points) — From array of Vector3
• setFromCenterAndSize(center, size) — From center + dimensions
• setFromObject(object, precise?) — Aggregate world-space bounds for an object hierarchy
• copy(box), makeEmpty()

setFromObject() prefers each object's engine-maintained boundingBoxWorld. If unavailable, it transforms geometry.boundingBox by matrixWorld. Groups contribute their descendants. Geometry-bearing objects without usable bounds are warned about and skipped.

Queries

• isEmpty() — True if any max component is less than its matching min
• getCenter(target) — Center point
• getSize(target) — Dimensions
• getParameter(point, target) — Point as proportion of box size
• getBoundingSphere(target) — Enclosing sphere

Testing

• containsPoint(point), containsBox(box)
• intersectsBox(box), intersectsSphere(sphere), intersectsPlane(plane), intersectsTriangle(triangle)

Operations

• expandByPoint(point), expandByVector(vector), expandByScalar(scalar)
• expandByObject(object, precise?) — Add world-space hierarchy bounds
• intersect(box) — Intersect with another box
• union(box) — Union with another box
• clampPoint(point, target) — Clamp point to box bounds
• distanceToPoint(point) — Distance from box edge to point
• applyMatrix4(matrix) — Transform box
• translate(offset) — Translate box

Other

• equals(box), clone()
• toJSON(), fromJSON(json)