BoundingBox — Aspose.3D FOSS for Python API Reference

Example

BoundingBox е кутия за ограничаване, ориентирана спрямо осите (AABB), определена от две Vector3 ъгли: minimum (най-ниски x, y, z) и maximum (най-високи x, y, z). Използва се за пространствени заявки като тестове точка-в-кутија, помощни функции за отрязване на фрустум и оценка на размера на ниво сцена.

Е BoundingBox може да бъде в null (празно/неинициализирано) състояние, когато е създаден без аргументи. Извикване merge() при null box я инициализира от първата предоставена точка или кутия.

Example: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Example

ExampleExample
BoundingBox()Null (празна) bounding box
BoundingBox(minimum, maximum)Конструира от две Vector3 ъгли
BoundingBox(min_x, min_y, min_z, max_x, max_y, max_z)Конструира от шест скаларни стойности

Example

ExampleExampleExample
minimumVector3Ъгълът с най-малките стойности за x, y, z. Връща (+inf, +inf, +inf) за null box
maximumVector3Ъгълът с най-големите стойности за x, y, z. Връща (-inf, -inf, -inf) за null кутия
centerVector3Средна точка между minimum и maximum; (0,0,0) за null кутия
sizeVector3Обхват по оси (maximum - minimum); (0,0,0) за null кутия

Статични фабрични методи

ExampleТип на връщанеExample
BoundingBox.get_null()BoundingBoxВръща null (празна) ограничителна кутия
BoundingBox.get_infinite()BoundingBoxВръща безкрайна ограничителна кутия, обхващаща цялото пространство

Методи на екземпляра

ExampleТип на връщанеExample
merge(point)NoneРазширява кутията, за да включи a Vector3, Vector4, или друг BoundingBox
merge(x, y, z)NoneРазширява кутията, за да включи точката (x, y, z)
contains(point)boolExample True ако Vector3 точката е вътре или на границата
contains(box)boolExample True ако box се намира изцяло в тази кутия
overlaps_with(box)boolExample True ако двете кутии се пресичат
scale()floatВръща най-голямата абсолютна стойност на координатата — полезно като груба оценка на мащаба на сцената

Example

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)

Вижте също

 Български