Class BoundingBox
Пакет: @aspose/3d (v24.12.0)
BoundingBox представлява кутия за ограничаване, подравнена по осите (AABB), в 3D пространство. Тя съхранява един minimum ъгъл и един maximum ъгъл като прости обекти с x, y, z полета. Новосъздаден BoundingBox() без аргументи е в „null“ състояние — minimum връща +Infinity и maximum връща -Infinity — и се разширява правилно, когато точки се добавят чрез merge(). BoundingBox се експортира от @aspose/3d/utilities подпът.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';Enumerations
Изчислете ограничителна кутия за набор от точки.
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() | Създава нулева ограничителна кутия. Разширява се, когато merge() се извика. |
new BoundingBox(minimum, maximum) | Създава кутия от две {x, y, z} ъглови обекти. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Създава кутия от шест скаларни компоненти. |
Статични свойства
| Enumerations | Enumerations | Enumerations |
|---|---|---|
BoundingBox.null | BoundingBox | Нулева ограничителна кутия (без обхват, не е инициализирана). |
BoundingBox.infinite | BoundingBox | Кутия, обхващаща целия числов диапазон от -Infinity до +Infinity. |
Enumerations
Важно именуване: BoundingBox използва minimum и maximum — не min и max.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
minimum | {x: number, y: number, z: number} (само за четене) | Ъгълът с най-малките стойности за x, y, z. Връща +Infinity по всяка ос, когато кутията е нулева. |
maximum | {x: number, y: number, z: number} (само за четене) | Ъгълът с най-големите стойности за x, y, z. Връща -Infinity по всяка ос, когато кутията е null. |
center | {x: number, y: number, z: number} (само за четене) | Геометричният център, изчислен като (minimum + maximum) / 2. Връща (0, 0, 0) когато е null. |
size | {x: number, y: number, z: number} (само за четене) | Размерите на кутията: maximum - minimum по ос. |
extent | BoundingBoxExtent (само за четене) | Полупростираните размери по всяка ос. Всяко поле е Math.abs(size / 2). |
Enumerations
merge(point)
Разширява ограничителната кутия, за да включи точка. Приема {x, y, z} обект, a Vector3, масив от 3 числа, или три отделни (x, y, z) аргументи.
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 ако дадената точка или ограничителна кутия е напълно вътре в тази кутия. Приема a {x, y, z} обект точка, a Vector3, или друг 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 ако тази ограничителна кутия се припокрива с друга BoundingBox (докосващите се ръбове се считат за припокриващи се).
overlapsWith(box: BoundingBox): booleanscale()
Връща максималната абсолютна стойност на координатата за всички ъгли, представляваща доминиращия мащаб на ограничителната кутия. Връща 0 когато кутията е null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent е спомагателен клас, върнат от BoundingBox.extent. Той съхранява половинните размери по всяка ос.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
extentX | number | Половин ширина по X. |
extentY | number | Половин височина по Y. |
extentZ | number | Половин дълбочина по Z. |