Cara Memuat Model 3D di Python

Aspose.3D FOSS for Python menyediakan API yang sederhana untuk membuka file 3D tanpa ketergantungan native apa pun. Setelah memuat file ke dalam objek Scene, Anda dapat menelusuri hierarki node dan membaca data geometri mentah untuk setiap mesh dalam adegan.

Panduan Langkah-demi-Langkah

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)

Masalah Umum dan Solusi

FileNotFoundError saat memanggil Scene.from_file()

Jalur harus bersifat absolut atau relatif yang benar terhadap direktori kerja pada saat runtime. Gunakan pathlib.Path untuk membuat jalur yang dapat diandalkan:

from pathlib import Path
from aspose.threed import Scene

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

mesh.polygons kosong setelah memuat file STL

File STL menyimpan segitiga sebagai faset mentah, bukan mesh terindeks. Setelah dimuat, poligon disintesis dari faset-faset tersebut. Jika polygons muncul kosong, periksa len(mesh.control_points); jika hitungannya merupakan kelipatan 3, geometri disimpan dalam bentuk tidak terindeks dan setiap tiga titik berturut‑turut membentuk satu segitiga.

Ketidaksesuaian sistem koordinat (model tampak diputar atau dicerminkan)

Berbagai alat menggunakan konvensi yang berbeda (Y-up vs Z-up, tangan kiri vs tangan kanan). Atur ObjLoadOptions.flip_coordinate_system = True atau terapkan rotasi pada Transform node akar setelah memuat.

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

Daftar entitas node dapat berisi entitas non‑mesh (kamera, lampu). Selalu lindungi dengan isinstance(entity, Mesh) sebelum melakukan casting.

Pertanyaan yang Sering Diajukan (FAQ)

Format 3D apa yang dapat saya muat?

OBJ (Wavefront), STL (binary dan ASCII), glTF 2.0 / GLB, COLLADA (DAE), dan 3MF. Tokenisasi file FBX didukung sebagian tetapi parsing lengkap belum selesai.

Apakah memuat file OBJ juga memuat material .mtl?

Ya, ketika ObjLoadOptions.enable_materials = True (default). Perpustakaan mencari file .mtl di direktori yang sama dengan file .obj. Jika .mtl tidak ada, geometri tetap dimuat dan peringatan dikeluarkan.

Bisakah saya memuat file dari aliran byte alih-alih jalur?

Ya. scene.open() menerima objek mirip file apa pun dengan metode .read() selain string jalur file. Lewatkan aliran biner terbuka (mis., io.BytesIO) secara langsung. Scene.from_file() hanya menerima string jalur file.

Bagaimana cara saya mendapatkan normal permukaan?

Setelah memuat, periksa mesh.get_element(VertexElementType.NORMAL). Ini mengembalikan sebuah VertexElementNormal yang daftar data‑nya berisi satu vektor normal per referensi, dipetakan sesuai mapping_mode dan reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

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

Apakah perpustakaan ini thread-safe untuk memuat beberapa file secara bersamaan?

Setiap Scene objek bersifat independen. Memuat file terpisah ke dalam Scene instance yang terpisah dari thread yang berbeda aman selama Anda tidak membagikan satu Scene antar thread tanpa penguncian eksternal.