Class BoundingBox
Balík: @aspose/3d (v24.12.0)
BoundingBox predstavuje osovo zarovnanú ohraničovaciu krabicu (AABB) v 3D priestore. Ukladá a minimum rohový bod a maximum rohový bod ako obyčajné objekty s x, y, z políčkami. Novo vytvorený BoundingBox() bez argumentov je v stave “null” — minimum vracia +Infinity a maximum vracia -Infinity — a správne sa rozširuje, keď sú body pridané cez merge(). BoundingBox je exportované z @aspose/3d/utilities podcesta.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';Properties
Sémantický typ pre dátovú vrstvu VertexElement.
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)
Properties
| Properties | Properties |
|---|---|
new BoundingBox() | Vytvorí nulovú ohraničovaciu krabicu. Rozšíri sa, keď merge() sa zavolá. |
new BoundingBox(minimum, maximum) | Vytvorí krabicu z dvoch {x, y, z} rohových objektov. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Vytvorí krabicu zo šiestich skalárnych komponentov. |
Statické vlastnosti
| Properties | Properties | Properties |
|---|---|---|
BoundingBox.null | BoundingBox | Nulová ohraničujúca krabica (žiadny rozsah, neinicializovaná). |
BoundingBox.infinite | BoundingBox | Box pokrývajúci celý číselný rozsah od -Infinity do +Infinity. |
Properties
Dôležité pomenovanie: BoundingBox používa minimum a maximum — nie min a max.
| Properties | Properties | Properties |
|---|---|---|
minimum | {x: number, y: number, z: number} (iba na čítanie) | Roh s najmenšími hodnotami x, y, z. Vráti +Infinity na každej osi, keď je box nulový. |
maximum | {x: number, y: number, z: number} (iba na čítanie) | Roh s najväčšími hodnotami x, y, z. Vráti -Infinity na každej osi, keď je box nulový. |
center | {x: number, y: number, z: number} (iba na čítanie) | Geometrické centrum, vypočítané ako (minimum + maximum) / 2. Vráti (0, 0, 0) keď je null. |
size | {x: number, y: number, z: number} (len na čítanie) | Rozmery krabice: maximum - minimum na osi. |
extent | BoundingBoxExtent (iba na čítanie) | Polovičné rozmery pozdĺž každej osi. Každé pole je Math.abs(size / 2). |
Properties
merge(point)
Rozšíri ohraničujúcu krabicu tak, aby zahŕňala bod. Prijíma a {x, y, z} objekt, a Vector3, pole 3 čísel, alebo tri samostatné (x, y, z) argumenty.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidProperties
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)
Properties true ak je daný bod alebo ohraničujúca krabica úplne vnútri tejto krabice. Prijíma a {x, y, z} bodový objekt, a Vector3, alebo ďalší BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanProperties
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)
Properties true ak sa táto ohraničujúca krabica pretína s inou BoundingBox (dotýkajúce sa hrany sa počítajú ako pretínanie).
overlapsWith(box: BoundingBox): booleanscale()
Vráti maximálnu absolútnu hodnotu súradnice zo všetkých rohov, ktorá predstavuje dominantnú mierku ohraničujúcej krabice. Vráti 0 keď je krabica null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent je sprievodná trieda vrátená BoundingBox.extent. Ukladá polovičné rozmery pozdĺž každej osi.
| Properties | Properties | Properties |
|---|---|---|
extentX | number | Polovičná šírka pozdĺž X. |
extentY | number | Polovičná výška pozdĺž Y. |
extentZ | number | Polovičná hĺbka pozdĺž Z. |