Aspose.3D FOSS
Python
PolygonModifier

PolygonModifier — Aspose.3D Python API Reference

Пакет: aspose.threed.entities (aspose-3d-foss 26.1.0)

PolygonModifier е статичен помощен клас, който предоставя операции за теселиране на полигони върху Mesh и Scene обекти. Всички методи са методи на класа; PolygonModifier никога не се инстанцира директно.

from aspose.threed.entities import PolygonModifier

Основната операция е триангулиране: преобразуване на четворъгълници и n‑гонове в триъгълници чрез метод „ear‑clipping“. Това е необходимо преди експортиране към формати, които приемат само триъгълна геометрия (STL, някои glTF конвейери).

Methods

triangulate(arg) — триангулирайте Mesh

Върнете нов Mesh в който всеки полигон е конвертиран в триъгълници. Оригиналната мрежа не се променя. Слоевете на върховите елементи (нормали, UV, цветове) се копират в новата мрежа.

@staticmethod
def triangulate(mesh: Mesh) -> Mesh
MethodsMethodsMethods
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) — триангулирайте всички мрежи в a Scene

Прегледайте целия граф на сцената и триангулирайте всеки Mesh обект на място. След този повик, в сцената не остават полигонни елементи, различни от триъгълници.

@staticmethod
def triangulate(scene: Scene) -> None
MethodsMethodsMethods
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]]
MethodsMethodsMethods
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]]
MethodsMethodsMethods
control_pointslist[Vector4]Масивът с позиции на върховете.
polygonslist[list[int]]Списък от дефиниции на полигони, всеки от които е списък с индекси на върховете.
generate_normalsboolMethods True, изчисли нормал на лицето за всеки изходен триъгълник.
normals_out`list[Vector3]None`

Връща: list[list[int]] — всички изходни триъгълни триплети в ред.

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

Вижте също

 Български