Class BoundingBox
Pachet: @aspose/3d (v24.12.0)
BoundingBox reprezintă o cutie de delimitare aliniată pe axe (AABB) în spațiu 3D. Stochează un minimum colț și un maximum colț ca obiecte simple cu x, y, z câmpuri. Un obiect nou construit BoundingBox() fără argumente se află în starea “null” — minimum returnează +Infinity și maximum returnează -Infinity — și se extinde corect când punctele sunt adăugate prin merge(). BoundingBox este exportat din @aspose/3d/utilities sub-cale.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';ColladaSaveOptions
Calculează o cutie de delimitare pentru un set de puncte.
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)
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
new BoundingBox() | Creează o cutie de delimitare nulă. Se extinde când merge() este apelat. |
new BoundingBox(minimum, maximum) | Creează o cutie din două {x, y, z} obiecte de colț. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Creează o cutie din șase componente scalare. |
Proprietăți statice
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
BoundingBox.null | BoundingBox | O cutie de delimitare nulă (fără extindere, neinițializată). |
BoundingBox.infinite | BoundingBox | O cutie care acoperă întregul interval numeric de la -Infinity până la +Infinity. |
ColladaSaveOptions
Denumire importantă: BoundingBox utilizează minimum și maximum — nu min și max.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (doar citire) | Colțul cu cele mai mici valori x, y, z. Returnează +Infinity pe fiecare axă când cutia este nulă. |
maximum | {x: number, y: number, z: number} (doar citire) | Colțul cu cele mai mari valori x, y, z. Returnează -Infinity pe fiecare axă când cutia este nulă. |
center | {x: number, y: number, z: number} (doar citire) | Centru geometric, calculat ca (minimum + maximum) / 2. Returnează (0, 0, 0) când este nulă. |
size | {x: number, y: number, z: number} (doar citire) | Dimensiunile cutiei: maximum - minimum pe axă. |
extent | BoundingBoxExtent (doar citire) | Jumătăți de extindere pe fiecare axă. Fiecare câmp este Math.abs(size / 2). |
ColladaSaveOptions
merge(point)
Extinde cutia delimitatoare pentru a include un punct. Acceptă un {x, y, z} obiect, un Vector3, un tablou de 3 numere, sau trei separate (x, y, z) argumente.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidColladaSaveOptions
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)
ColladaSaveOptions true dacă punctul sau cutia delimitatoare dată este complet în interiorul acestei cutii. Acceptă un {x, y, z} obiect punct, un Vector3, sau altul BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanColladaSaveOptions
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)
ColladaSaveOptions true dacă această cutie delimitatoare se suprapune cu alta BoundingBox (marginile care se ating sunt considerate suprapuse).
overlapsWith(box: BoundingBox): booleanscale()
Returnează valoarea maximă absolută a coordonatei pentru toate colțurile, reprezentând scara dominantă a cutiei delimitatoare. Returnează 0 când cutia este nulă.
scale(): numberBoundingBoxExtent
BoundingBoxExtent este o clasă companion returnată de BoundingBox.extent. Stochează jumătăţi de dimensiuni de-a lungul fiecărui ax.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
extentX | number | Jumătate de lăţime pe axa X. |
extentY | number | Jumătate de înălţime pe axa Y. |
extentZ | number | Jumătate de adâncime pe axa Z. |