PolygonModifier
חבילה: aspose.threed.entities (aspose-3d-foss 26.1.0)
PolygonModifier היא מחלקת שירות סטטית המספקת פעולות טסלציה של פוליגונים על Mesh ו Scene אובייקטים. כל השיטות הן שיטות מחלקה; PolygonModifier אינה נוצרת ישירות.
from aspose.threed.entities import PolygonModifierהפעולה העיקרית היא תלתון: המרת קוודרנטים ו‑n‑גונים למשולשים באמצעות חיתוך אוזניים. פעולה זו נדרשת לפני ייצוא לפורמטים שמקבלים רק גאומטריית משולשים (STL, כמה צינורות glTF).
Methods
triangulate(arg) — לבצע תלתון של Mesh
מחזיר אובייקט חדש Mesh שבו כל פוליגון הומר למשולשים. הרשת המקורית אינה משתנה. שכבות רכיבי הקודקוד (normals, UVs, colours) מועתקות לרשת החדשה.
@staticmethod
def triangulate(mesh: Mesh) -> Mesh| Methods | Methods | Methods |
|---|---|---|
mesh | Mesh | רשת המקור לתלתון. |
מחזיר: Mesh — רשת חדשה המכילה רק פוליגונים משולשים.
from aspose.threed.entities import Mesh, PolygonModifier
from aspose.threed.utilities import Vector4
mesh = Mesh()
# Use _control_points to mutate the backing list (control_points returns a copy)
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) # 2triangulate(scene) — לבצע תלתון של כל הרשתות ב Scene
לנווט את כל גרף הסצנה ולבצע תלתון לכל Mesh ישות במקום. לאחר קריאה זו, לא נותרו פוליגונים שאינם משולשים בסצנה.
@staticmethod
def triangulate(scene: Scene) -> None| Methods | Methods | Methods |
|---|---|---|
scene | Scene | הסצנה שהרשתות שלה יועברו לתלתון. |
מחזיר: 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.
@staticmethod
def triangulate(
control_points: list[Vector4],
polygon: list[int],
) -> list[list[int]]| Methods | Methods | Methods |
|---|---|---|
control_points | list[Vector4] | מערך המיקומים המלא של הקודקודים. |
polygon | list[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]]| Methods | Methods | Methods |
|---|---|---|
control_points | list[Vector4] | מערך מיקומי הקודקודים. |
polygons | list[list[int]] | רשימה של הגדרות פוליגון, שכל אחת היא רשימה של אינדקסי קודקוד. |
generate_normals | bool | Methods 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