Class BoundingBox
Pakket: @aspose/3d (v24.12.0)
BoundingBox vertegenwoordigt een axis-aligned bounding box (AABB) in 3D-ruimte. Het slaat een minimum corner en een maximum corner als eenvoudige objecten met x, y, z velden. Een nieuw geconstrueerd BoundingBox() zonder argumenten bevindt zich in de “null”-status — minimum geeft terug +Infinity en maximum geeft terug -Infinity — en breidt correct uit wanneer punten worden toegevoegd via merge(). BoundingBox wordt geëxporteerd vanuit de @aspose/3d/utilities sub-pad.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';BoundingBoxExtent
Bereken een begrenzingsdoos voor een verzameling punten.
import { BoundingBox, Vector3 } from '@aspose/3d/utilities';
const points = [
new Vector3(-1, 0, -1),
new Vector3(1, 2, 1),
new Vector3(0, -0.5, 0),
];
const bbox = new BoundingBox();
for (const p of points) {
bbox.merge(p);
}
console.log(`Min: (${bbox.minimum.x}, ${bbox.minimum.y}, ${bbox.minimum.z})`);
// Min: (-1, -0.5, -1)
console.log(`Max: (${bbox.maximum.x}, ${bbox.maximum.y}, ${bbox.maximum.z})`);
// Max: (1, 2, 1)
const c = bbox.center;
console.log(`Center: (${c.x}, ${c.y.toFixed(3)}, ${c.z})`);
// Center: (0, 0.750, 0)
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
new BoundingBox() | Maakt een null bounding box. Breidt uit wanneer merge() wordt aangeroepen. |
new BoundingBox(minimum, maximum) | Creëert een doos van twee {x, y, z} hoekobjecten. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Maakt een box van zes scalare componenten. |
Statische eigenschappen
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
BoundingBox.null | BoundingBox | Een null bounding box (geen omvang, niet geïnitialiseerd). |
BoundingBox.infinite | BoundingBox | Een box die het volledige getalbereik beslaat van -Infinity tot +Infinity. |
BoundingBoxExtent
Belangrijke naamgeving: BoundingBox gebruikt minimum en maximum — niet min en max.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
minimum | {x: number, y: number, z: number} (alleen-lezen) | De hoek met de kleinste x-, y- en z-waarden. Retourneert +Infinity op elke as wanneer de box null is. |
maximum | {x: number, y: number, z: number} (alleen-lezen) | De hoek met de grootste x-, y- en z-waarden. Retourneert -Infinity op elke as wanneer de box null is. |
center | {x: number, y: number, z: number} (alleen-lezen) | Het geometrisch centrum, berekend als (minimum + maximum) / 2. Retourneert (0, 0, 0) wanneer null. |
size | {x: number, y: number, z: number} (alleen-lezen) | De afmetingen van de box: maximum - minimum per as. |
extent | BoundingBoxExtent (alleen-lezen) | Half-extents langs elke as. Elk veld is Math.abs(size / 2). |
BoundingBoxExtent
merge(point)
Vergroot de begrenzingsbox om een punt op te nemen. Accepteert een {x, y, z} object, een Vector3, een array van 3 getallen, of drie afzonderlijke (x, y, z) argumenten.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidBoundingBoxExtent
import { BoundingBox, Vector3 } from '@aspose/3d/utilities';
const bb = new BoundingBox();
bb.merge(new Vector3(2, 3, 4));
bb.merge(-1, 0, 0);
console.log(`Min X: ${bb.minimum.x}`); // Min X: -1
console.log(`Max Y: ${bb.maximum.y}`); // Max Y: 3
contains(arg)
BoundingBoxExtent true als het opgegeven punt of de begrenzingsbox volledig binnen deze box ligt. Accepteert een {x, y, z} puntobject, een Vector3, of een andere BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanBoundingBoxExtent
import { BoundingBox, Vector3 } from '@aspose/3d/utilities';
const bb = new BoundingBox(-1, -1, -1, 1, 1, 1);
console.log(bb.contains(new Vector3(0, 0, 0))); // true
console.log(bb.contains(new Vector3(2, 0, 0))); // false
overlapsWith(box)
BoundingBoxExtent true als deze begrenzingsbox overlapt met een andere BoundingBox (raakende randen tellen als overlappend).
overlapsWith(box: BoundingBox): booleanscale()
Retourneert de maximale absolute coördinaatwaarde over alle hoeken, die de dominante schaal van de begrenzingsdoos vertegenwoordigt. Retourneert 0 wanneer de box null is.
scale(): numberBoundingBoxExtent
BoundingBoxExtent is een begeleidende klasse die wordt geretourneerd door BoundingBox.extent. Het slaat half-extents op langs elke as.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
extentX | number | Halve breedte langs X. |
extentY | number | Halve hoogte langs Y. |
extentZ | number | Halve diepte langs Z. |