Cara Memuatkan Model 3D dalam Python

Aspose.3D FOSS for Python menyediakan API yang mudah untuk membuka fail 3D tanpa sebarang kebergantungan natif. Selepas memuatkan fail ke dalam objek Scene, anda boleh menelusuri hierarki nod dan membaca data geometri mentah bagi 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)

Isu Umum dan Penyelesaian

FileNotFoundError semasa memanggil Scene.from_file()

Laluan mesti mutlak atau relatif yang betul kepada direktori kerja semasa runtime. Gunakan pathlib.Path untuk membina laluan yang boleh dipercayai:

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 selepas memuatkan fail STL

Fail STL menyimpan segitiga sebagai faset mentah, bukan mesh berindeks. Selepas dimuatkan, poligon disintesis daripada faset‑faset tersebut. Jika polygons kelihatan kosong, periksa len(mesh.control_points); jika kiraannya merupakan gandaan 3, geometri disimpan dalam bentuk tidak berindeks dan setiap tiga titik berturutan membentuk satu segitiga.

Ketidakcocokan sistem koordinat (model kelihatan diputar atau dipantulkan)

Alat yang berbeza menggunakan konvensyen yang berbeza (Y-up vs Z-up, tangan kiri vs tangan kanan). Tetapkan ObjLoadOptions.flip_coordinate_system = True atau terapkan putaran pada Transform nod akar selepas memuatkan.

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

Senarai entiti nod mungkin mengandungi entiti bukan‑mesh (kamera, lampu). Sentiasa lindungi dengan isinstance(entity, Mesh) sebelum menukar.

Soalan Lazim (FAQ)

Format 3D mana yang boleh dimuat?

OBJ (Wavefront), STL (binari dan ASCII), glTF 2.0 / GLB, COLLADA (DAE), dan 3MF. Tokenisasi fail FBX disokong secara separa tetapi penguraian penuh belum selesai.

Adakah memuatkan fail OBJ juga memuatkan bahan .mtl?

Ya, apabila ObjLoadOptions.enable_materials = True (lalai). Perpustakaan mencari fail .mtl dalam direktori yang sama dengan fail .obj. Jika .mtl tidak ada, geometri masih dimuatkan dan amaran dikeluarkan.

Bolehkah saya memuatkan fail daripada aliran bait dan bukannya laluan?

Ya. scene.open() menerima sebarang objek seperti fail dengan kaedah .read() selain daripada rentetan laluan fail. Hantar aliran binari terbuka (contohnya, io.BytesIO) secara langsung. Scene.from_file() hanya menerima rentetan laluan fail.

Bagaimana saya dapat normal permukaan?

Selepas dimuatkan, periksa mesh.get_element(VertexElementType.NORMAL). Ini mengembalikan VertexElementNormal yang senarai datanya mengandungi satu vektor normal bagi setiap rujukan, dipetakan mengikut 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

Adakah perpustakaan thread-safe untuk memuatkan berbilang fail secara serentak?

Setiap Scene objek adalah bebas. Memuatkan fail berasingan ke dalam contoh Scene yang berasingan dari benang berasingan adalah selamat selagi anda tidak berkongsi satu Scene merentasi benang tanpa kunci luaran.