Aspose.3D FOSS
Python
BoundingBox

BoundingBox — Aspose.3D FOSS for Python API Reference

Example

BoundingBox 是一个轴对齐的包围盒（AABB），由两个 Vector3 角点：: minimum （最低的 x、y、z）和 maximum （最高的 x、y、z）。它用于空间查询，例如点在盒子内测试、视锥体剔除辅助以及场景级别的尺寸估计。.

一个 BoundingBox 可以处于一个 空 （空/未初始化）状态，当使用无参数创建时。调用 merge() 在空盒子上会使用提供的第一个点或盒子进行初始化。.

Example: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Example

ExampleExample
BoundingBox()空（未初始化）包围盒
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) 对于空盒子
maximumVector3具有最大 x、y、z 值的角点。返回 (-inf, -inf, -inf) 用于 null box
centerVector3之间的中点 minimum 和 maximum; (0,0,0) 用于 null box
sizeVector3每轴的范围 (maximum - minimum); (0,0,0) 对于空盒子

静态工厂方法

Example返回类型Example
BoundingBox.get_null()BoundingBox返回一个空（空的）边界框
BoundingBox.get_infinite()BoundingBox返回一个覆盖整个空间的无限边界框

实例方法

Example返回类型Example
merge(point)None将盒子扩展以包含一个 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)

另见

 中文