PolygonModifier — Aspose.3D Python API Reference

Pachet: aspose.threed.entities (aspose-3d-foss 26.1.0)

PolygonModifier este o clasă utilitară statică care furnizează operații de teselație a poligoanelor pe Mesh și Scene obiecte. Toate metodele sunt metode de clasă; PolygonModifier nu este niciodată instanțiată direct.

from aspose.threed.entities import PolygonModifier

Operația principală este triangularea: convertirea cvadratelor și n-gonurilor în triunghiuri utilizând metoda de tăiere a urechii. Aceasta este necesară înainte de exportarea în formate care acceptă doar geometrie triunghiulară (STL, unele fluxuri glTF).

triangulate(arg) — teselați un Mesh

Returnează un nou Mesh în care fiecare poligon a fost convertit în triunghiuri. Mesh-ul original nu este modificat. Straturile de elemente ale vârfurilor (normale, UV-uri, culori) sunt copiate în mesh-ul nou.

@staticmethod
def triangulate(mesh: Mesh) -> Mesh

Returnează: Mesh — un mesh nou care conține doar poligoane triunghi.

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) — triangulează toate mesh-urile dintr-un Scene

Parcurge întregul graf al scenei și triangulează fiecare Mesh entitate la fața locului. După acest apel, nu mai rămân poligoane care nu sunt triunghiuri în scenă.

@staticmethod
def triangulate(scene: Scene) -> None

Returnează: 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) — triangulează un singur poligon

Suprasarcină de nivel scăzut: dată o listă de puncte de control și o listă de indici de vârf care formează un poligon, returnează o listă de triplete de indici de triunghi produse prin triangulare tip fan.

@staticmethod
def triangulate(
    control_points: list[Vector4],
    polygon: list[int],
) -> list[list[int]]

Returnează: list[list[int]] — o listă de [i, j, k] triplete, fiecare reprezentând un triunghi de ieșire.

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) — triangulare în lot cu generare opțională de normale

Triangulează în lot o listă de liste de indici de poligon. Opțional calculează normalele feței pentru fiecare triunghi de ieșire și le adaugă la 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]]

Returnează: list[list[int]] — toate tripletele de triunghiuri de ieșire în ordine.

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

Vezi și

• Referință la clasa Mesh
• Referință la clasa Scene
• Referință la clasa VertexElement