Aspose.3D FOSS
Python
BoundingBox

BoundingBox — Aspose.3D FOSS for Python API Reference

Methods

BoundingBox es una caja delimitadora alineada a los ejes (AABB) definida por dos Vector3 esquinas: minimum (x, y, z más bajo) y maximum (x, y, z más alto). Se utiliza para consultas espaciales como pruebas de punto dentro de la caja, auxiliares de recorte de frustrum y estimación de tamaño a nivel de escena.

Una BoundingBox puede estar en un nulo (estado vacío/no inicializado) cuando se crea sin argumentos. Llamar merge() en una caja nula la inicializa a partir del primer punto o caja proporcionado.

Methods: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Methods

MethodsMethods
BoundingBox()Caja delimitadora nula (vacía)
BoundingBox(minimum, maximum)Construye a partir de dos Vector3 esquinas
BoundingBox(min_x, min_y, min_z, max_x, max_y, max_z)Construye a partir de seis valores escalares

Methods

MethodsMethodsMethods
minimumVector3La esquina con los valores más pequeños de x, y, z. Devuelve (+inf, +inf, +inf) para una caja nula
maximumVector3La esquina con los valores más grandes de x, y, z. Devuelve (-inf, -inf, -inf) para una caja nula
centerVector3Punto medio entre minimum y maximum; (0,0,0) para una caja nula
sizeVector3Extensión por eje (maximum - minimum); (0,0,0) para una caja nula

Métodos de fábrica estáticos

MethodsTipo de retornoMethods
BoundingBox.get_null()BoundingBoxDevuelve una caja delimitadora nula (vacía)
BoundingBox.get_infinite()BoundingBoxDevuelve una caja delimitadora infinita que abarca todo el espacio

Métodos de instancia

MethodsTipo de retornoMethods
merge(point)NoneExpande la caja para incluir un Vector3, Vector4, o otro BoundingBox
merge(x, y, z)NoneExpande la caja para incluir el punto (x, y, z)
contains(point)boolMethods True si el Vector3 el punto está dentro o en el límite
contains(box)boolMethods True si box está completamente dentro de esta caja
overlaps_with(box)boolMethods True si las dos cajas se intersectan
scale()floatDevuelve el valor absoluto de coordenada más grande — útil como una estimación aproximada de la escala de la escena

Methods 

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)

Ver también

 Español