Class BoundingBox
بسته: @aspose/3d (v24.12.0)
BoundingBox یک جعبه محدودکننده محور-محور (AABB) در فضای سهبعدی را نشان میدهد. این جعبه یک minimum گوشه و یک maximum گوشه بهعنوان اشیاء ساده با x, y, z فیلدها. یک شیء تازه ساختهشده BoundingBox() بدون هیچ آرگومان در حالت “null” قرار دارد — minimum بازمیگرداند +Infinity و maximum باز میگرداند -Infinity — و بهدرستی گسترش مییابد وقتی نقاط از طریق merge(). BoundingBox از این صادر میشود @aspose/3d/utilities زیرمسیر.
export class BoundingBoximport { 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
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
new BoundingBox() | یک جعبه مرزی تهی ایجاد میکند. گسترش مییابد وقتی merge() فراخوانی میشود. |
new BoundingBox(minimum, maximum) | یک جعبه از دو {x, y, z} اشیای گوشهای. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | یک جعبه را از شش مؤلفه اسکالر ایجاد میکند. |
ویژگیهای ایستا
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
BoundingBox.null | BoundingBox | یک جعبه مرزی تهی (بدون ابعاد، مقداردهی اولیه نشده). |
BoundingBox.infinite | BoundingBox | جعبهای که کل بازه عددی را از -Infinity تا +Infinity. |
ColladaSaveOptions
نامگذاری مهم: BoundingBox استفاده میکند minimum و maximum — نه min و max.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (فقط-خواندنی) | گوشهای که کمترین مقادیر x، y، z را دارد. برمیگرداند +Infinity در هر محور زمانی که جعبه تهی باشد. |
maximum | {x: number, y: number, z: number} (فقط-خواندنی) | گوشهای که بیشترین مقادیر x، y، z را دارد. برمیگرداند -Infinity در هر محور زمانی که جعبه تهی باشد. |
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). |
ColladaSaveOptions
merge(point)
جعبه محدودکننده را برای شامل کردن یک نقطه گسترش میدهد. یک {x, y, z} شیء، یک Vector3, آرایهای از ۳ عدد، یا سه مقدار جداگانه (x, y, z) آرگومانها.
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 اگر نقطه یا جعبه مرزی داده شده کاملاً داخل این جعبه باشد. یک {x, y, z} شیء نقطه، یک Vector3, یا دیگری 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 اگر این جعبه مرزی با دیگری همپوشانی داشته باشد BoundingBox (لمس لبهها به عنوان همپوشانی در نظر گرفته میشود).
overlapsWith(box: BoundingBox): booleanscale()
بیشترین مقدار مطلق مختصات را در تمام گوشهها برمیگرداند، که مقیاس غالب جعبه مرزی را نشان میدهد. برمیگرداند 0 زمانی که جعبه null باشد.
scale(): numberBoundingBoxExtent
BoundingBoxExtent یک کلاس کمکی است که توسط BoundingBox.extent. این کلاس نیمهابعاد را در هر محور ذخیره میکند.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
extentX | number | نیمهعرض در محور X. |
extentY | number | نیمهارتفاع در محور Y. |
extentZ | number | نیمهعمق در محور Z. |