Class BoundingBox
Paket: @aspose/3d (v24.12.0)
BoundingBox representerar en axeljusterad begränsningslåda (AABB) i 3D-rymden. Den lagrar en minimum hörn och en maximum hörn som enkla objekt med x, y, z fält. En nykonstruerad BoundingBox() utan argument är i “null”-tillståndet — minimum returnerar +Infinity och maximum returnerar -Infinity — och expanderar korrekt när punkter läggs till via merge(). BoundingBox exporteras från den @aspose/3d/utilities under-sökväg.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';ImageRenderOptions
Beräkna en avgränsningslåda för en uppsättning punkter.
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)
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
new BoundingBox() | Skapar en null-begränsningslåda. Expanderar när merge() anropas. |
new BoundingBox(minimum, maximum) | Skapar en låda från två {x, y, z} hörnobjekt. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Skapar en låda från sex skalära komponenter. |
Statiska egenskaper
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
BoundingBox.null | BoundingBox | En null begränsningslåda (ingen omfattning, inte initierad). |
BoundingBox.infinite | BoundingBox | En låda som sträcker sig över hela talintervallet från -Infinity till +Infinity. |
ImageRenderOptions
Viktig namngivning: BoundingBox använder minimum och maximum — inte min och max.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
minimum | {x: number, y: number, z: number} (skrivskyddad) | Hörnet med de minsta x-, y- och z-värdena. Returnerar +Infinity på varje axel när lådan är null. |
maximum | {x: number, y: number, z: number} (skrivskyddad) | Hörnet med de största x-, y- och z-värdena. Returnerar -Infinity på varje axel när lådan är null. |
center | {x: number, y: number, z: number} (skrivskyddad) | Det geometriska centrumet, beräknat som (minimum + maximum) / 2. Returnerar (0, 0, 0) när null. |
size | {x: number, y: number, z: number} (skrivskyddad) | Boxens dimensioner: maximum - minimum per axel. |
extent | BoundingBoxExtent (skrivskyddad) | Halvextenter längs varje axel. Varje fält är Math.abs(size / 2). |
ImageRenderOptions
merge(point)
Utökar bounding box för att inkludera en punkt. Accepterar en {x, y, z} objekt, en Vector3, en array med 3 tal, eller tre separata (x, y, z) argument.
merge(point: Vector3 | {x: number, y: number, z: number}): void
merge(x: number, y: number, z: number): voidImageRenderOptions
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)
ImageRenderOptions true om den givna punkten eller bounding boxen är helt innanför denna låda. Accepterar en {x, y, z} punktobjekt, en Vector3, eller en annan BoundingBox.
contains(arg: Vector3 | {x: number, y: number, z: number} | BoundingBox): booleanImageRenderOptions
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)
ImageRenderOptions true om denna bounding box överlappar med en annan BoundingBox (rörande kanter räknas som överlappning).
overlapsWith(box: BoundingBox): booleanscale()
Returnerar det maximala absoluta koordinatvärdet över alla hörn, vilket representerar den dominerande skalan för bounding boxen. Returnerar 0 när lådan är null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent är en komplementklass som returneras av BoundingBox.extent. Den lagrar halvextenter längs varje axel.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
extentX | number | Halvbredd längs X. |
extentY | number | Halvhöjd längs Y. |
extentZ | number | Halvdjup längs Z. |