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()Δημιουργεί ένα κουτί περιβάλλουσας null. Επεκτείνεται όταν 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, έναν πίνακα 3 αριθμών, ή τρία ξεχωριστά (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.
 Ελληνικά