Class BoundingBox
Pakke: @aspose/3d (v24.12.0)
BoundingBox representerer en aksejustert avgrensningsboks (AABB) i 3D-rom. Den lagrer en minimum hjørne og en maximum hjørne som enkle objekter med x, y, z felter. En nyopprettet BoundingBox() uten argumenter er i “null”-tilstand — minimum returnerer +Infinity og maximum returnerer -Infinity — og utvides korrekt når punkter legges til via merge(). BoundingBox eksporteres fra den @aspose/3d/utilities understi.
export class BoundingBoximport { BoundingBox } from '@aspose/3d/utilities';BoundingBoxExtent
Kameraklasse referanse.
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() | Oppretter en null avgrensningsboks. Utvides når merge() kalles. |
new BoundingBox(minimum, maximum) | Oppretter en boks fra to {x, y, z} hjørneobjekter. |
new BoundingBox(minX, minY, minZ, maxX, maxY, maxZ) | Oppretter en boks fra seks skalære komponenter. |
Lysklasse referanse
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
BoundingBox.null | BoundingBox | En null avgrensningsboks (ingen utstrekning, ikke initialisert). |
BoundingBox.infinite | BoundingBox | En boks som spenner over hele tallområdet fra -Infinity til +Infinity. |
BoundingBoxExtent
Viktig navngivning: BoundingBox bruker minimum og maximum — ikke min og max.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
minimum | {x: number, y: number, z: number} (kun lesing) | Hjørnet med de minste x-, y- og z-verdiene. Returnerer +Infinity på hver akse når boksen er null. |
maximum | {x: number, y: number, z: number} (kun lesing) | Hjørnet med de største x-, y- og z-verdiene. Returnerer -Infinity på hver akse når boksen er null. |
center | {x: number, y: number, z: number} (kun lesing) | Det geometriske sentrum, beregnet som (minimum + maximum) / 2. Returnerer (0, 0, 0) når null. |
size | {x: number, y: number, z: number} (skrivebeskyttet) | Dimensjonene til boksen: maximum - minimum per akse. |
extent | BoundingBoxExtent (kun lesing) | Halv-omfang langs hver akse. Hvert felt er Math.abs(size / 2). |
BoundingBoxExtent
merge(point)
Utvider begrensningsboksen for å inkludere et punkt. Aksepterer en {x, y, z} objekt, en Vector3, en array med 3 tall, eller tre separate (x, y, z) argumenter.
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 hvis det gitte punktet eller begrensningsboksen er helt innenfor denne boksen. Aksepterer en {x, y, z} punktobjekt, en Vector3, eller en annen 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 hvis denne begrensningsboksen overlapper med en annen BoundingBox (berørende kanter teller som overlapp).
overlapsWith(box: BoundingBox): booleanscale()
Returnerer den maksimale absolutte koordinatverdien over alle hjørner, som representerer den dominerende skalaen til begrensningsboksen. Returnerer 0 når boksen er null.
scale(): numberBoundingBoxExtent
BoundingBoxExtent er en ledsagende klasse som returneres av BoundingBox.extent. Den lagrer halv-omfang langs hver akse.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
extentX | number | Halv bredde langs X. |
extentY | number | Halv høyde langs Y. |
extentZ | number | Halv dybde langs Z. |