Class BoundingBox
Balíček: @aspose/3d (v24.12.0)
BoundingBox představuje osově zarovnaný ohraničující kvádr (AABB) ve 3D prostoru. Ukládá minimum roh a maximum roh jako jednoduché objekty s x, y, z políčky. Nově vytvořený BoundingBox() bez argumentů je ve stavu „null“ — minimum vrací +Infinity a maximum vrací -Infinity — a rozšiřuje se správně, když jsou body přidány pomocí merge(). BoundingBox je exportováno z @aspose/3d/utilities podcesty.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';Enumerations
Vypočítejte ohraničující krabici pro množinu bodů.
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)
Enumerations
| Enumerations | Enumerations |
|---|---|
new BoundingBox() | Vytvoří nulový ohraničující kvádr. Rozšíří se, když merge() je zavoláno. |
new BoundingBox(minimum, maximum) | Vytvoří krabici ze dvou {x, y, z} rohových objektů. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Vytvoří krabici ze šesti skalárních komponent. |
Statické vlastnosti
| Enumerations | Enumerations | Enumerations |
|---|---|---|
BoundingBox.null | BoundingBox | Nulová ohraničující krabice (žádný rozsah, není inicializována). |
BoundingBox.infinite | BoundingBox | Krabice zahrnující celé číselné rozmezí od -Infinity do +Infinity. |
Enumerations
Důležitá pojmenování: BoundingBox používá minimum a maximum — ne min a max.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
minimum | {x: number, y: number, z: number} (pouze pro čtení) | Roh s nejmenšími hodnotami x, y, z. Vrací +Infinity na každé ose, když je krabice nulová. |
maximum | {x: number, y: number, z: number} (pouze pro čtení) | Roh s největšími hodnotami x, y, z. Vrací -Infinity na každé ose, když je krabice nulová. |
center | {x: number, y: number, z: number} (pouze pro čtení) | Geometrické středisko, vypočtené jako (minimum + maximum) / 2. Vrací (0, 0, 0) když je null. |
size | {x: number, y: number, z: number} (pouze pro čtení) | Rozměry krabice: maximum - minimum na každou osu. |
extent | BoundingBoxExtent (pouze pro čtení) | Poloviční rozměry podél každé osy. Každé pole je Math.abs(size / 2). |
Enumerations
merge(point)
Rozšíří ohraničující krabici tak, aby zahrnovala bod. Přijímá {x, y, z} objekt, Vector3,pole tří čísel, nebo tři samostatné (x, y, z) argumenty.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidEnumerations
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)
Enumerations true zjistí, zda je daný bod nebo ohraničující krabice zcela uvnitř této krabice. Přijímá {x, y, z} objekt bodu, Vector3, nebo jiný BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanEnumerations
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)
Enumerations true zjistí, zda se tato ohraničující krabice překrývá s jinou BoundingBox (dotýkající se hrany se počítají jako překrývající se).
overlapsWith(box: BoundingBox): booleanscale()
Vrací maximální absolutní hodnotu souřadnice napříč všemi rohy, představující dominantní měřítko ohraničující krabice. Vrací 0 když je krabice null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent je doprovodná třída vrácená metodou BoundingBox.extent. Ukládá poloviční rozměry podél každé osy.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
extentX | number | Poloviční šířka podél X. |
extentY | number | Poloviční výška podél Y. |
extentZ | number | Poloviční hloubka podél Z. |