Class BoundingBox
Paket: @aspose/3d (v24.12.0)
BoundingBox mewakili kotak pembatas yang sejajar sumbu (AABB) dalam ruang 3D. Ia menyimpan sebuah minimum sudut dan sebuah maximum sudut sebagai objek sederhana dengan x, y, z field. Sebuah objek yang baru dibangun BoundingBox() tanpa argumen berada dalam keadaan “null” — minimum mengembalikan +Infinity dan maximum mengembalikan -Infinity — dan berkembang dengan benar ketika titik-titik ditambahkan melalui merge(). BoundingBox dieksport dari @aspose/3d/utilities sub-jalur.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';BoundingBoxExtent
Hitung kotak pembatas untuk sekumpulan titik.
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)
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
new BoundingBox() | Membuat kotak pembatas null. Berkembang ketika merge() dipanggil. |
new BoundingBox(minimum, maximum) | Membuat kotak dari dua {x, y, z} objek sudut. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Membuat kotak dari enam komponen skalar. |
Properti Statis
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
BoundingBox.null | BoundingBox | Kotak pembatas null (tidak ada jangkauan, tidak diinisialisasi). |
BoundingBox.infinite | BoundingBox | Sebuah kotak yang mencakup seluruh rentang angka dari -Infinity hingga +Infinity. |
BoundingBoxExtent
Penamaan penting: BoundingBox menggunakan minimum dan maximum — tidak min dan max.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
minimum | {x: number, y: number, z: number} (hanya-baca) | Sudut dengan nilai x, y, z terkecil. Mengembalikan +Infinity pada setiap sumbu ketika kotak bernilai null. |
maximum | {x: number, y: number, z: number} (hanya-baca) | Sudut dengan nilai x, y, z terbesar. Mengembalikan -Infinity pada setiap sumbu ketika kotak bernilai null. |
center | {x: number, y: number, z: number} (hanya-baca) | Pusat geometrik, dihitung sebagai (minimum + maximum) / 2. Mengembalikan (0, 0, 0) ketika null. |
size | {x: number, y: number, z: number} (hanya-baca) | Dimensi kotak: maximum - minimum per sumbu. |
extent | BoundingBoxExtent (hanya-baca) | Half-extents sepanjang setiap sumbu. Setiap bidang adalah Math.abs(size / 2). |
BoundingBoxExtent
merge(point)
Memperluas bounding box untuk menyertakan sebuah titik. Menerima sebuah {x, y, z} objek, sebuah Vector3, sebuah array berisi 3 angka, atau tiga terpisah (x, y, z) argumen.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidBoundingBoxExtent
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)
BoundingBoxExtent true jika titik atau bounding box yang diberikan sepenuhnya berada di dalam kotak ini. Menerima sebuah {x, y, z} objek titik, sebuah Vector3, atau yang lain BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanBoundingBoxExtent
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)
BoundingBoxExtent true jika bounding box ini tumpang tindih dengan yang lain BoundingBox (tepi yang bersentuhan dihitung sebagai tumpang tindih).
overlapsWith(box: BoundingBox): booleanscale()
Mengembalikan nilai koordinat absolut maksimum di semua sudut, yang mewakili skala dominan dari bounding box. Mengembalikan 0 ketika kotak bernilai null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent adalah kelas pendamping yang dikembalikan oleh BoundingBox.extent. Ia menyimpan half-extents sepanjang setiap sumbu.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
extentX | number | Setengah lebar sepanjang X. |
extentY | number | Setengah tinggi sepanjang Y. |
extentZ | number | Setengah kedalaman sepanjang Z. |