Class BoundingBox
Pacote: @aspose/3d (v24.12.0)
BoundingBox representa uma caixa delimitadora alinhada aos eixos (AABB) no espaço 3D. Ela armazena um minimum canto e um maximum canto como objetos simples com x, y, z campos. Um novo objeto construído BoundingBox() sem argumentos está no estado “null” — minimum retorna +Infinity e maximum retorna -Infinity — e expande corretamente quando pontos são adicionados via merge(). BoundingBox é exportado a partir do @aspose/3d/utilities subcaminho.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';ColladaSaveOptions
Referência da classe Camera.
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() | Cria uma caixa delimitadora nula. Expande quando merge() é chamado. |
new BoundingBox(minimum, maximum) | Cria uma caixa a partir de dois {x, y, z} objetos de canto. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Cria uma caixa a partir de seis componentes escalares. |
Referência da classe Light
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
BoundingBox.null | BoundingBox | Uma caixa delimitadora nula (sem extensão, não inicializada). |
BoundingBox.infinite | BoundingBox | Uma caixa que abrange toda a faixa numérica de -Infinity até +Infinity. |
ColladaSaveOptions
Nomeação importante: BoundingBox usa minimum e maximum — não min e max.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (somente leitura) | O canto com os menores valores de x, y, z. Retorna +Infinity em cada eixo quando a caixa é nula. |
maximum | {x: number, y: number, z: number} (somente leitura) | O canto com os maiores valores de x, y, z. Retorna -Infinity em cada eixo quando a caixa é nula. |
center | {x: number, y: number, z: number} (somente leitura) | O centro geométrico, calculado como (minimum + maximum) / 2. Retorna (0, 0, 0) quando nula. |
size | {x: number, y: number, z: number} (somente leitura) | As dimensões da caixa: maximum - minimum por eixo. |
extent | BoundingBoxExtent (somente leitura) | Metades das extensões ao longo de cada eixo. Cada campo é Math.abs(size / 2). |
ColladaSaveOptions
merge(point)
Expande a caixa delimitadora para incluir um ponto. Aceita um {x, y, z} objeto, um Vector3, um array de 3 números, ou três separados (x, y, z) argumentos.
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 o ponto ou caixa delimitadora fornecido está totalmente dentro desta caixa. Aceita um {x, y, z} objeto ponto, um Vector3, ou outro 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 esta caixa delimitadora se sobrepõe a outra BoundingBox (bordas que se tocam contam como sobreposição).
overlapsWith(box: BoundingBox): booleanscale()
Retorna o valor absoluto máximo da coordenada em todos os cantos, representando a escala dominante da caixa delimitadora. Retorna 0 quando a caixa é nula.
scale(): numberBoundingBoxExtent
BoundingBoxExtent é uma classe companheira retornada por BoundingBox.extent. Ele armazena metade das extensões ao longo de cada eixo.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
extentX | number | Metade da largura ao longo de X. |
extentY | number | Metade da altura ao longo de Y. |
extentZ | number | Metade da profundidade ao longo de Z. |