Class BoundingBox

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 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

ColladaSaveOptionsColladaSaveOptions
new BoundingBox()یک جعبه مرزی تهی ایجاد می‌کند. گسترش می‌یابد وقتی merge() فراخوانی می‌شود.
new BoundingBox(minimum, maximum)یک جعبه از دو {x, y, z} اشیای گوشه‌ای.
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ)یک جعبه را از شش مؤلفه اسکالر ایجاد می‌کند.

ویژگی‌های ایستا

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
BoundingBox.nullBoundingBoxیک جعبه مرزی تهی (بدون ابعاد، مقداردهی اولیه نشده).
BoundingBox.infiniteBoundingBoxجعبه‌ای که کل بازه عددی را از -Infinity تا +Infinity.

ColladaSaveOptions

نام‌گذاری مهم: BoundingBox استفاده می‌کند minimum و maximum — نه min و max.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
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 در هر محور.
extentBoundingBoxExtent (فقط‑خواندنی)نیمه‌طول‌ها در هر محور. هر فیلد 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): 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} شیء نقطه، یک 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 اگر این جعبه مرزی با دیگری همپوشانی داشته باشد BoundingBox (لمس لبه‌ها به عنوان همپوشانی در نظر گرفته می‌شود).

overlapsWith(box: BoundingBox): boolean

scale()

بیشترین مقدار مطلق مختصات را در تمام گوشه‌ها برمی‌گرداند، که مقیاس غالب جعبه مرزی را نشان می‌دهد. برمی‌گرداند 0 زمانی که جعبه null باشد.

scale(): number

BoundingBoxExtent

BoundingBoxExtent یک کلاس کمکی است که توسط BoundingBox.extent. این کلاس نیمه‌ابعاد را در هر محور ذخیره می‌کند.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
extentXnumberنیمه‌عرض در محور X.
extentYnumberنیمه‌ارتفاع در محور Y.
extentZnumberنیمه‌عمق در محور Z.
 فارسی