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 边形转换为三角形。这在导出仅接受三角形几何的格式（STL、某些 glTF 流程）之前是必需的。.

triangulate(arg) — 对…进行三角化 Mesh

返回一个新的 Mesh 其中每个多边形都已转换为三角形。原始网格未被修改。顶点元素层（法线、UV、颜色）被复制到新网格中。.

@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) — 对单个多边形进行三角剖分

底层重载：给定控制点列表和构成单个多边形的顶点索引列表，返回由扇形三角化产生的三角形索引三元组列表。.

@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]] — 所有输出三角形三元组按顺序。.

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

另见

 中文