Aspose.3D FOSS
Python
BoundingBox

BoundingBox — Aspose.3D FOSS for Python API Reference

Enumerations

BoundingBox è un bounding box allineato agli assi (AABB) definito da due Vector3 angoli: minimum (x, y, z più bassi) e maximum (x, y, z più alti). Viene utilizzato per query spaziali come test punto‑in‑box, assistenti di frustum culling e stima delle dimensioni a livello di scena.

Un BoundingBox può trovarsi in una null (vuoto/non inizializzato) stato quando viene creato senza argomenti. Chiamare merge() su un box null lo inizializza dal primo punto o box fornito.

Enumerations: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Enumerations

EnumerationsEnumerations
BoundingBox()Bounding box Null (vuoto)
BoundingBox(minimum, maximum)Costruisce da due Vector3 angoli
BoundingBox(min_x, min_y, min_z, max_x, max_y, max_z)Costruisce a partire da sei valori scalari

Enumerations

EnumerationsEnumerationsEnumerations
minimumVector3L’angolo con i valori x, y, z più piccoli. Restituisce (+inf, +inf, +inf) per un box nullo
maximumVector3L’angolo con i valori x, y, z più grandi. Restituisce (-inf, -inf, -inf) per un box nullo
centerVector3Punto medio tra minimum e maximum; (0,0,0) per un box nullo
sizeVector3Estensione per asse (maximum - minimum); (0,0,0) per un box nullo

Metodi di fabbrica statici

EnumerationsTipo di ritornoEnumerations
BoundingBox.get_null()BoundingBoxRestituisce un bounding box nullo (vuoto)
BoundingBox.get_infinite()BoundingBoxRestituisce un bounding box infinito che si estende su tutto lo spazio

Metodi di Istanza

EnumerationsTipo di ritornoEnumerations
merge(point)NoneEspande il box per includere un Vector3, Vector4, o un altro BoundingBox
merge(x, y, z)NoneEspande il box per includere il punto (x, y, z)
contains(point)boolEnumerations True se il Vector3 il punto è all’interno o sul confine
contains(box)boolEnumerations True se box è interamente all’interno di questo box
overlaps_with(box)boolEnumerations True se i due box si intersecano
scale()floatRestituisce il valore assoluto più grande della coordinata — utile come stima approssimativa della scala della scena

Enumerations 

from aspose.threed.utilities import BoundingBox, Vector3

# Build a bounding box from a list of points
bb = BoundingBox()
points = [
    Vector3(0.0, 0.0, 0.0),
    Vector3(1.0, 2.0, 3.0),
    Vector3(-1.0, 0.5, 1.5),
]
for p in points:
    bb.merge(p)

print(bb.minimum)   # Vector3(-1.0, 0.0, 0.0)
print(bb.maximum)   # Vector3(1.0, 2.0, 3.0)
print(bb.center)    # Vector3(0.0, 1.0, 1.5)
print(bb.size)      # Vector3(2.0, 2.0, 3.0)

# Point containment
print(bb.contains(Vector3(0.5, 1.0, 1.5)))   # True
print(bb.contains(Vector3(5.0, 0.0, 0.0)))   # False

# Box containment
inner = BoundingBox(Vector3(0, 0, 0), Vector3(0.5, 0.5, 0.5))
print(bb.contains(inner))   # True

# Overlap test
other = BoundingBox(Vector3(0.5, 0.5, 0.5), Vector3(2.0, 2.0, 2.0))
print(bb.overlaps_with(other))   # True

# Retrieve from a node
from aspose.threed import Scene
from aspose.threed.entities import Mesh
from aspose.threed.utilities import Vector4

scene = Scene()
mesh = Mesh()
mesh.control_points.append(Vector4(-1, 0, 0, 1))
mesh.control_points.append(Vector4( 1, 0, 0, 1))
mesh.control_points.append(Vector4( 0, 1, 0, 1))
mesh.create_polygon(0, 1, 2)
node = scene.root_node.create_child_node("tri", mesh)
node_bb = node.get_bounding_box()
print(node_bb.minimum)
print(node_bb.maximum)

Vedi anche

 Italiano