Class BoundingBox
Pacchetto: @aspose/3d (v24.12.0)
BoundingBox rappresenta un bounding box allineato agli assi (AABB) nello spazio 3D. Memorizza un minimum vertice e un maximum vertice come oggetti semplici con x, y, z campi. Un nuovo BoundingBox() costruito senza argomenti è nello stato “null” — minimum restituisce +Infinity e maximum restituisce -Infinity — e si espande correttamente quando i punti vengono aggiunti tramite merge(). BoundingBox viene esportato dal @aspose/3d/utilities sottopercorso.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';ColladaSaveOptions
GltfLoadOptions estende LoadOptions. Non espone proprietà aggiuntive visibili all’utente nella versione corrente; passa un’istanza predefinita per utilizzare le impostazioni consigliate.
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() | Crea un bounding box nullo. Si espande quando merge() viene chiamato. |
new BoundingBox(minimum, maximum) | Crea un box da due {x, y, z} oggetti d’angolo. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Crea un box da sei componenti scalari. |
Examples
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
BoundingBox.null | BoundingBox | Una bounding box nulla (senza estensione, non inizializzata). |
BoundingBox.infinite | BoundingBox | Una box che copre l’intero intervallo numerico da -Infinity a +Infinity. |
ColladaSaveOptions
Nomenclatura importante: BoundingBox usa minimum e maximum — non min e max.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (sola lettura) | L’angolo con i valori più piccoli di x, y, z. Restituisce +Infinity su ciascun asse quando la box è nulla. |
maximum | {x: number, y: number, z: number} (sola lettura) | L’angolo con i valori più grandi di x, y, z. Restituisce -Infinity su ciascun asse quando la box è nulla. |
center | {x: number, y: number, z: number} (sola lettura) | Il centro geometrico, calcolato come (minimum + maximum) / 2. Restituisce (0, 0, 0) quando è null. |
size | {x: number, y: number, z: number} (sola lettura) | Le dimensioni della scatola: maximum - minimum per asse. |
extent | BoundingBoxExtent (sola lettura) | Semi-estensioni lungo ogni asse. Ogni campo è Math.abs(size / 2). |
ColladaSaveOptions
merge(point)
Espande il riquadro di delimitazione per includere un punto. Accetta un {x, y, z} oggetto, un Vector3, un array di 3 numeri, o tre separati (x, y, z) argomenti.
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 se il punto o il box di delimitazione fornito è completamente all’interno di questo box. Accetta un {x, y, z} oggetto punto, un Vector3, o un altro 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 se questo box di delimitazione si sovrappone a un altro BoundingBox (i bordi che si toccano contano come sovrapposti).
overlapsWith(box: BoundingBox): booleanscale()
Restituisce il valore di coordinata assoluta massimo tra tutti gli angoli, rappresentando la scala dominante del box di delimitazione. Restituisce 0 quando il box è nullo.
scale(): numberBoundingBoxExtent
BoundingBoxExtent è una classe complementare restituita da BoundingBox.extent. Memorizza le semi-estensioni lungo ogni asse.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
extentX | number | Mezza larghezza lungo X. |
extentY | number | Mezza altezza lungo Y. |
extentZ | number | Mezza profondità lungo Z. |