Aspose.3D FOSS
Python
BoundingBox

BoundingBox

Methods

BoundingBox é uma caixa delimitadora alinhada aos eixos (AABB) definida por dois Vector3 cantos: minimum (menor x, y, z) e maximum (maior x, y, z). É usada para consultas espaciais como testes ponto‑em‑caixa, auxiliares de recorte de frustum e estimativa de tamanho em nível de cena.

Um BoundingBox pode estar em um nulo (vazio/não inicializado) estado quando criado sem argumentos. Chamando merge() em uma caixa nula inicializa-a a partir do primeiro ponto ou caixa fornecida.

Methods: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Methods

MethodsMethods
BoundingBox()Caixa delimitadora nula (vazia)
BoundingBox(minimum, maximum)Constrói a partir de duas Vector3 cantos
BoundingBox(min_x, min_y, min_z, max_x, max_y, max_z)Constrói a partir de seis valores escalares

Methods

MethodsMethodsMethods
minimumVector3O canto com os menores valores de x, y, z. Retorna (+inf, +inf, +inf) para uma caixa nula
maximumVector3O canto com os maiores valores de x, y, z. Retorna (-inf, -inf, -inf) para uma caixa nula
centerVector3Ponto médio entre minimum e maximum; (0,0,0) para uma caixa nula
sizeVector3Extensão por eixo (maximum - minimum); (0,0,0) para uma caixa nula

Métodos de Fábrica Estáticos

MethodsTipo de RetornoMethods
BoundingBox.get_null()BoundingBoxRetorna uma caixa delimitadora nula (vazia)
BoundingBox.get_infinite()BoundingBoxRetorna uma caixa delimitadora infinita que abrange todo o espaço

Métodos de Instância

MethodsTipo de RetornoMethods
merge(point)NoneExpande a caixa para incluir um Vector3, Vector4, ou outro BoundingBox
merge(x, y, z)NoneExpande a caixa para incluir o ponto (x, y, z)
contains(point)boolMethods True se o Vector3 ponto está dentro ou na fronteira
contains(box)boolMethods True se box está totalmente dentro desta caixa
overlaps_with(box)boolMethods True se as duas caixas se intersectarem
scale()floatRetorna o maior valor absoluto de coordenada — útil como uma estimativa aproximada da escala da cena

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()
# Use _control_points to mutate the backing list (control_points returns a copy)
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)

Veja Também

 Português