Aspose.3D FOSS
Python
BoundingBox

BoundingBox — Aspose.3D FOSS for Python API Reference

Overview

BoundingBox เป็นกล่องขอบเขตที่จัดแนวตามแกน (AABB) ที่กำหนดโดยสอง Vector3 มุม: minimum (ค่าต่ำสุดของ x, y, z) และ maximum (ค่ามากสุดของ x, y, z). มันใช้สำหรับการสืบค้นเชิงพื้นที่ เช่น การทดสอบจุดในกล่อง, ตัวช่วยการตัดเฟรสซัม, และการประมาณขนาดระดับฉาก.

A BoundingBox สามารถอยู่ใน null (สถานะว่าง/ไม่ได้กำหนดค่า) เมื่อสร้างโดยไม่มีอาร์กิวเมนต์. การเรียก merge() บนกล่อง null จะทำการเริ่มต้นจากจุดหรือกล่องแรกที่ให้มา.

Overview: aspose.threed.utilities

from aspose.threed.utilities import BoundingBox, Vector3

Overview

OverviewOverview
BoundingBox()กล่องขอบเขต Null (ว่าง)
BoundingBox(minimum, maximum)สร้างจากสอง Vector3 มุม
BoundingBox(min_x, min_y, min_z, max_x, max_y, max_z)สร้างจากหกค่าตัวเลขสเกลาร์

Overview

OverviewOverviewOverview
minimumVector3มุมที่มีค่าต่ำสุดของ x, y, z. คืนค่า (+inf, +inf, +inf) สำหรับกล่อง null
maximumVector3มุมที่มีค่ามากสุดของ x, y, z. คืนค่า (-inf, -inf, -inf) สำหรับ null box
centerVector3จุดกึ่งกลางระหว่าง minimum และ maximum; (0,0,0) สำหรับ null box
sizeVector3ขนาดต่อแกน (maximum - minimum); (0,0,0) สำหรับกล่องว่าง

เมธอดแฟคทอรีแบบสแตติก

Overviewประเภทการคืนค่าOverview
BoundingBox.get_null()BoundingBoxคืนค่ากล่องขอบเขตที่เป็นศูนย์ (ว่างเปล่า)
BoundingBox.get_infinite()BoundingBoxคืนค่ากล่องขอบเขตที่ไม่มีที่สิ้นสุดครอบคลุมทุกพื้นที่

เมธอดอินสแตนซ์

Overviewประเภทการคืนค่าOverview
merge(point)Noneขยายกล่องเพื่อรวม a Vector3, Vector4, หรืออีกหนึ่ง BoundingBox
merge(x, y, z)Noneขยายกล่องเพื่อรวมจุด (x, y, z)
contains(point)boolOverview True ถ้า Vector3 จุดอยู่ภายในหรือบนขอบเขต
contains(box)boolOverview True ถ้า box อยู่ภายในกล่องนี้อย่างสมบูรณ์
overlaps_with(box)boolOverview True ถ้ากล่องสองกล่องตัดกัน
scale()floatคืนค่าค่าพิกัดสัมบูรณ์ที่ใหญ่ที่สุด — มีประโยชน์เป็นการประมาณขนาดฉากโดยคร่าวๆ

Overview 

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)

ดูเพิ่มเติม

 ภาษาไทย