Class BoundingBox
Pakiet: @aspose/3d (v24.12.0)
BoundingBox reprezentuje prostopadłościenną ramkę ograniczającą (AABB) w przestrzeni 3D. Przechowuje minimum wierzchołek i maximum wierzchołek jako proste obiekty z x, y, z polami. Nowo utworzony BoundingBox() bez argumentów znajduje się w stanie “null” — minimum zwraca +Infinity oraz maximum zwraca -Infinity — i rozszerza się prawidłowo, gdy punkty są dodawane za pomocą merge(). BoundingBox jest eksportowany z @aspose/3d/utilities ścieżki podrzędnej.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';ColladaSaveOptions
Odwołanie do klasy Light.
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() | Tworzy pustą ramkę ograniczającą. Rozszerza się, gdy merge() jest wywoływana. |
new BoundingBox(minimum, maximum) | Tworzy ramkę z dwóch {x, y, z} obiektów narożnych. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Tworzy ramkę z sześciu składowych skalarnych. |
Wszystkie wyliczenia w @aspose/3d: ProjectionType, LightType, TextureMapping, BooleanOperation, VertexElementType, MappingMode, ReferenceMode
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
BoundingBox.null | BoundingBox | Pusta ramka ograniczająca (brak rozmiaru, niezainicjowana). |
BoundingBox.infinite | BoundingBox | Ramka obejmująca cały zakres liczb od -Infinity do +Infinity. |
ColladaSaveOptions
Ważne nazewnictwo: BoundingBox używa minimum i maximum — nie min i max.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (tylko do odczytu) | Róg o najmniejszych wartościach x, y, z. Zwraca +Infinity na każdej osi, gdy pudełko jest puste. |
maximum | {x: number, y: number, z: number} (tylko do odczytu) | Róg o największych wartościach x, y, z. Zwraca -Infinity na każdej osi, gdy pudełko jest null. |
center | {x: number, y: number, z: number} (tylko do odczytu) | Środek geometryczny, obliczany jako (minimum + maximum) / 2. Zwraca (0, 0, 0) gdy null. |
size | {x: number, y: number, z: number} (tylko do odczytu) | Wymiary pudełka: maximum - minimum na oś. |
extent | BoundingBoxExtent (tylko do odczytu) | Połówki wymiarów wzdłuż każdej osi. Każde pole jest Math.abs(size / 2). |
ColladaSaveOptions
merge(point)
Rozszerza ramkę ograniczającą, aby obejmowała punkt. Akceptuje a {x, y, z} obiekt, a Vector3, tablica 3 liczb, lub trzy oddzielne (x, y, z) argumenty.
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 jeśli podany punkt lub prostokąt ograniczający znajduje się w pełni wewnątrz tego boxu. Akceptuje a {x, y, z} obiekt punktu, a Vector3, lub inny 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 jeśli ten bounding box zachodzi na inny BoundingBox (dotykające krawędzie liczą się jako zachodzące).
overlapsWith(box: BoundingBox): booleanscale()
Zwraca maksymalną wartość bezwzględną współrzędnej ze wszystkich rogów, reprezentującą dominującą skalę bounding boxu. Zwraca 0 gdy box jest null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent jest klasą towarzyszącą zwracaną przez BoundingBox.extent. Przechowuje połowy wymiarów wzdłuż każdej osi.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
extentX | number | Połowa szerokości wzdłuż osi X. |
extentY | number | Połowa wysokości wzdłuż osi Y. |
extentZ | number | Połowa głębokości wzdłuż osi Z. |