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 BoundingBox

import { BoundingBox } from '@aspose/3d/utilities';

ColladaSaveOptions

Вычислить ограничивающий параллелепипед для набора точек.

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

Quaternion.fromRotation(orig, dest)

ColladaSaveOptions

Важные названия: BoundingBox использует minimum и maximum — не min и max.

ColladaSaveOptions

merge(point)

Расширяет ограничивающий прямоугольник, чтобы включить точку. Принимает {x, y, z} объект, Vector3, массив из 3 чисел, или три отдельных (x, y, z) аргументы.

merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): void

ColladaSaveOptions

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 если заданная точка или ограничивающий прямоугольник полностью находятся внутри этого прямоугольника. Принимает {x, y, z} объект point, a Vector3, или другой BoundingBox.

contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): boolean

ColladaSaveOptions

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 если этот bounding box перекрывается с другим BoundingBox (касание краёв считается перекрытием).

overlapsWith(box: BoundingBox): boolean

scale()

Возвращает максимальное абсолютное значение координаты по всем углам, представляющее доминирующий масштаб bounding box. Возвращает 0 когда box равен null.

scale(): number

BoundingBoxExtent

BoundingBoxExtent является вспомогательным классом, возвращаемым BoundingBox.extent. Он хранит половинные размеры вдоль каждой оси.