Class BoundingBox
Paket: @aspose/3d (v24.12.0)
BoundingBox predstavlja osno poravnatu granicnu kutiju (AABB) u 3D prostoru. Ona čuva minimum ugao i maximum ugao kao obične objekte sa x, y, z poljima. Novo konstruisan BoundingBox() bez argumenata je u “null” stanju — minimum vraća +Infinity i maximum vraća -Infinity — i pravilno se proširuje kada se tačke dodaju putem merge(). BoundingBox se izvozi iz @aspose/3d/utilities poddirektorijuma.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';BoundingBoxExtent
Izračunajte okvir ograničenja za skup tačaka.
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() | Kreira null bounding box. Proširuje se kada merge() se pozove. |
new BoundingBox(minimum, maximum) | Kreira kutiju od dva {x, y, z} ugla objekata. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Kreira kutiju od šest skalarnih komponenti. |
Statička svojstva
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
BoundingBox.null | BoundingBox | Nulta ograničavajuća kutija (bez obima, nije inicijalizovana). |
BoundingBox.infinite | BoundingBox | Kutija koja obuhvata čitav brojčani opseg od -Infinity do +Infinity. |
BoundingBoxExtent
Važno imenovanje: BoundingBox koristi minimum i maximum — ne min i max.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
minimum | {x: number, y: number, z: number} (samo za čitanje) | Temena sa najmanjim vrednostima x, y, z. Vraća +Infinity na svakoj osi kada je kutija null. |
maximum | {x: number, y: number, z: number} (samo za čitanje) | Ugao sa najvećim x, y, z vrednostima. Vraća -Infinity po svakoj osi kada je kutija null. |
center | {x: number, y: number, z: number} (samo za čitanje) | Geometrijski centar, izračunat kao (minimum + maximum) / 2. Vraća (0, 0, 0) kada je null. |
size | {x: number, y: number, z: number} (samo za čitanje) | Dimenzije kutije: maximum - minimum po osi. |
extent | BoundingBoxExtent (samo za čitanje) | Polu‑dimenzije duž svake ose. Svako polje je Math.abs(size / 2). |
BoundingBoxExtent
merge(point)
Proširuje ograničavajući okvir da uključi tačku. Prihvata a {x, y, z} objekat, a Vector3, niz od 3 broja, ili tri odvojena (x, y, z) argumenta.
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 ako je data tačka ili ograničavajući okvir potpuno unutar ovog okvira. Prihvata a {x, y, z} objekat tačke, a Vector3, ili drugi 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 ako se ovaj okvir preklapa sa drugim BoundingBox (dodirivanje ivica se računa kao preklapanje).
overlapsWith(box: BoundingBox): booleanscale()
Vraća maksimalnu apsolutnu vrednost koordinate kroz sve uglove, predstavljajući dominantnu skalu okvira. Vraća 0 kada je okvir null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent je prateća klasa koju vraća BoundingBox.extent. Čuva polu‑dimenzije duž svake ose.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
extentX | number | Poluširina duž X. |
extentY | number | Poluvisina duž Y. |
extentZ | number | Poludubina duž Z. |