כיצד לטעון מודלים תלת‑ממדיים בפייתון

Aspose.3D FOSS for Python מספק API פשוט לפתיחת קבצי 3D ללא תלותיות מקומיות. לאחר טעינת קובץ לאובייקט Scene, ניתן לעבור על היררכיית הצמתים ולקרוא נתוני גאומטריה גולמיים עבור כל רשת בסצנה.

מדריך שלב אחר שלב

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

##Automatic format detection
scene = Scene.from_file("model.obj")

scene = Scene()
scene.open("model.obj")

from aspose.threed import Scene, Node

scene = Scene.from_file("model.obj")

def walk(node: Node, depth: int = 0) -> None:
    indent = "  " * depth
    print(f"{indent}Node: {node.name!r}")
    for child in node.child_nodes:
        walk(child, depth + 1)

walk(scene.root_node)

from aspose.threed import Scene
from aspose.threed.entities import Mesh

scene = Scene.from_file("model.obj")

for node in scene.root_node.child_nodes:
    for entity in node.entities:
        if isinstance(entity, Mesh):
            mesh: Mesh = entity
            print(f"Mesh '{node.name}': "
                  f"{len(mesh.control_points)} vertices, "
                  f"{len(mesh.polygons)} polygons")

            # First vertex position
            if mesh.control_points:
                v = mesh.control_points[0]
                print(f"  First vertex: ({v.x:.4f}, {v.y:.4f}, {v.z:.4f})")

            # First polygon face (list of control-point indices)
            if mesh.polygons:
                print(f"  First polygon: {mesh.polygons[0]}")

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

options = ObjLoadOptions()
options.flip_coordinate_system = True   # Convert right-hand Y-up to Z-up
options.scale = 0.01                    # Convert centimetres to metres
options.enable_materials = True         # Load .mtl material file
options.normalize_normal = True         # Normalize all normals to unit length

scene = Scene()
scene.open("model.obj", options)

בעיות נפוצות ותיקונים

FileNotFoundError בעת קריאה לScene.from_file()

הנתיב חייב להיות מוחלט או יחסי נכון לתיקיית העבודה בזמן הריצה. השתמש בpathlib.Path כדי לבנות נתיבים אמינים:

from pathlib import Path
from aspose.threed import Scene

path = Path(__file__).parent / "assets" / "model.obj"
scene = Scene.from_file(str(path))

mesh.polygons ריק לאחר טעינת קובץ STL

קבצי STL שומרים משולשים כפרצופים גולמיים, ולא כרשת ממוספרת. לאחר הטעינה, פוליגונים מסונתזים מהפרצופים האלה. אם polygons מופיע ריק, בדוק את len(mesh.control_points); אם הספירה היא כפולה של 3, הגיאומטריה נשמרת בצורה בלתי ממוספרת וכל שלושה קודקודים רצופים יוצרים משולש אחד.

אי התאמת מערכת הקואורדינטות (המודל נראה מסובב או משוקף)

כלים שונים משתמשים בקונבנציות שונות (Y‑up לעומת Z‑up, יד שמאלית לעומת יד ימנית). הגדר ObjLoadOptions.flip_coordinate_system = True או החל סיבוב על Transform של צומת השורש לאחר הטעינה.

AttributeError: 'NoneType' object has no attribute 'polygons'

רשימת הישויות של צומת עשויה להכיל ישויות שאינן רשת (מצלמות, אורות). תמיד יש להגן עם isinstance(entity, Mesh) לפני ההמרה.

שאלות נפוצות (FAQ)

אילו פורמטים תלת‑ממדיים אני יכול לטעון?

OBJ (Wavefront), STL (בינארי ו‑ASCII), glTF 2.0 / GLB, COLLADA (DAE), ו‑3MF. טוקניזציית קבצי FBX נתמכת חלקית אך הפענוח המלא עדיין אינו מושלם.

האם טעינת קובץ OBJ טוענת גם את החומר .mtl?

כן, כאשר ObjLoadOptions.enable_materials = True (ברירת המחדל). הספרייה מחפשת את קובץ .mtl באותה תיקייה כמו קובץ .obj. אם .mtl חסר, הגאומטריה עדיין נטענת והזהרה נשלחת.

האם ניתן לטעון קובץ מזרם בתים במקום נתיב?

כן. scene.open() מקבל כל אובייקט דמוי קובץ עם שיטת .read() בנוסף למחרוזת נתיב קובץ. העבר זרם בינארי פתוח (למשל, io.BytesIO) ישירות. Scene.from_file() מקבל רק מחרוזת נתיב קובץ.

איך אני מקבל נורמליות של משטח?

לאחר הטעינה, בדוק mesh.get_element(VertexElementType.NORMAL). פעולה זו מחזירה VertexElementNormal שהרשימה data שלו מכילה וקטור נורמלי אחד לכל הפנייה, ממופה לפי mapping_mode וreference_mode.

from aspose.threed.entities import Mesh, VertexElementType

normals = mesh.get_element(VertexElementType.NORMAL)
if normals:
    print(normals.data[0])  # First normal vector

האם הספרייה בטוחה לשימוש מרובה‑תהליכים לטעינת קבצים מרובים במקביל?

כל אובייקט Scene הוא עצמאי. טעינת קבצים נפרדים לתוך מופעים נפרדים של Scene מתוך חוטים נפרדים היא בטוחה כל עוד אינך חולק Scene יחיד בין חוטים ללא נעילה חיצונית.