Aspose.3D FOSS
Python
PolygonModifier

PolygonModifier — Aspose.3D Python API Reference

แพคเกจ: aspose.threed.entities (aspose-3d-foss 26.1.0)

PolygonModifier เป็นคลาสยูทิลิตี้แบบสแตติกที่ให้การดำเนินการ tessellation ของโพลิกอนบน Mesh และ Scene อ็อบเจ็กต์ทั้งหมด วิธีการทั้งหมดเป็นเมธอดของคลาส; PolygonModifier จะไม่ถูกสร้างอินสแตนซ์โดยตรง.

from aspose.threed.entities import PolygonModifier

การดำเนินการหลักคือการทำให้เป็นรูปสามเหลี่ยม: แปลงควอดและ n‑gon ให้เป็นสามเหลี่ยมโดยใช้วิธี ear‑clipping. สิ่งนี้จำเป็นก่อนการส่งออกไปยังฟอร์แมตที่รับเฉพาะเรขาคณิตรูปสามเหลี่ยม (STL, บาง pipeline ของ glTF).

triangulate(arg) — แปลงเป็นสามเหลี่ยมของ Mesh

คืนค่าใหม่ Mesh ที่ซึ่งโพลิกอนทุกตัวถูกแปลงเป็นสามเหลี่ยม เมชต้นฉบับจะไม่ถูกแก้ไข ชั้นขององค์ประกอบเวอร์เท็กซ์ (normals, UVs, colours) จะถูกคัดลอกไปยังเมชใหม่.

@staticmethod
def triangulate(mesh: Mesh) -> Mesh
meshMeshเมชต้นทางที่ต้องการแปลงเป็นสามเหลี่ยม.

คืนค่า: Mesh — เมชใหม่ที่มีเพียงโพลิกอนรูปสามเหลี่ยมเท่านั้น.

from aspose.threed.entities import Mesh, PolygonModifier
from aspose.threed.utilities import Vector4

mesh = Mesh()
for x, z in [(0, 0), (1, 0), (1, 1), (0, 1)]:
    mesh.control_points.append(Vector4(float(x), 0.0, float(z), 1.0))
mesh.create_polygon(0, 1, 2, 3)   # one quad

tri_mesh = PolygonModifier.triangulate(mesh)
print(tri_mesh.polygon_count)     # 2

triangulate(scene) — แปลงเป็นสามเหลี่ยมเมชทั้งหมดใน Scene

สำรวจกราฟซีนทั้งหมดและแปลงเป็นสามเหลี่ยมทุก Mesh เอนทิตีในที่เดียว หลังจากเรียกนี้ จะไม่มีโพลิกอนที่ไม่ใช่สามเหลี่ยมเหลืออยู่ในซีน.

@staticmethod
def triangulate(scene: Scene) -> None
sceneSceneซีนที่เมชเอนทิตีของมันจะถูกแปลงเป็นสามเหลี่ยม.

คืนค่า: None

from aspose.threed import Scene
from aspose.threed.entities import PolygonModifier

scene = Scene.from_file("model_with_quads.obj")
PolygonModifier.triangulate(scene)
scene.save("model_triangulated.stl")

triangulate(control_points, polygon) — แยกสามเหลี่ยมรูปหลายเหลี่ยมเดียว

โอเวอร์โหลดระดับต่ำ: ให้รายการของจุดควบคุมและรายการของดัชนีเวอร์เท็กซ์ที่ประกอบเป็นโพลิกอนหนึ่ง, คืนค่ารายการของทริปเล็ตดัชนีสามเหลี่ยมที่สร้างโดยการทำ fan triangulation.

@staticmethod
def triangulate(
    control_points: list[Vector4],
    polygon: list[int],
) -> list[list[int]]
control_pointslist[Vector4]อาเรย์ตำแหน่งเวอร์เท็กซ์เต็ม.
polygonlist[int]ดัชนีไปยัง control_points กำหนดรูปหลายเหลี่ยมที่จะแบ่ง.

คืนค่า: list[list[int]] — รายการของ [i, j, k] ชุดสามค่า, แต่ละชุดแสดงถึงสามเหลี่ยมผลลัพธ์หนึ่งรูป.

from aspose.threed.entities import PolygonModifier
from aspose.threed.utilities import Vector4

pts = [
    Vector4(0.0, 0.0, 0.0, 1.0),
    Vector4(1.0, 0.0, 0.0, 1.0),
    Vector4(1.0, 1.0, 0.0, 1.0),
    Vector4(0.0, 1.0, 0.0, 1.0),
]
quad_indices = [0, 1, 2, 3]
triangles = PolygonModifier.triangulate(pts, quad_indices)
print(triangles)   # e.g. [[0, 1, 2], [0, 2, 3]]

triangulate(control_points, polygons, generate_normals, normals_out) — ทำการไตรแองเกิลแบบชุดพร้อมการสร้างนอร์มอลแบบเลือกได้

ทำการไตรแองเกิลแบบชุดกับรายการของดัชนีรูปหลายเหลี่ยมหลายรายการ. สามารถคำนวณนอร์มอลของหน้าแต่ละสามเหลี่ยมผลลัพธ์ได้ตามต้องการและต่อท้ายลงใน normals_out.

@staticmethod
def triangulate(
    control_points: list[Vector4],
    polygons: list[list[int]],
    generate_normals: bool = False,
    normals_out: list[Vector3] | None = None,
) -> list[list[int]]
control_pointslist[Vector4]อาเรย์ตำแหน่งเวอร์เท็กซ์.
polygonslist[list[int]]รายการของการกำหนดรูปหลายเหลี่ยม, แต่ละรายการเป็นลิสต์ของดัชนีเวอร์เท็กซ์.
generate_normalsbool
True, คำนวณนอร์มอลของหน้าแต่ละสามเหลี่ยมผลลัพธ์.
normals_out`list[Vector3]None`

คืนค่า: list[list[int]] — ชุดสามค่า (triplets) ของสามเหลี่ยมผลลัพธ์ทั้งหมดตามลำดับ.

from aspose.threed.entities import PolygonModifier
from aspose.threed.utilities import Vector4, Vector3

pts = [
    Vector4(0, 0, 0, 1), Vector4(1, 0, 0, 1),
    Vector4(1, 1, 0, 1), Vector4(0, 1, 0, 1),
]
polys = [[0, 1, 2, 3]]
normals: list[Vector3] = []
tris = PolygonModifier.triangulate(pts, polys, True, normals)
print(len(tris))     # 2
print(len(normals))  # 2

ดูเพิ่มเติม

 ภาษาไทย