Cara Memuat Model 3D dalam Python

Aspose.3D FOSS untuk Python menyediakan API yang mudah untuk membuka fail 3D tanpa sebarang kebergantungan asli. Selepas memuatkan fail ke dalam a Scene objek, anda boleh menelusuri hierarki nod dan membaca data geometri mentah untuk setiap mesh dalam adegan.

Panduan Langkah demi Langkah

pip install aspose-3d-foss

import aspose.threed
print(aspose.threed.__version__)  # e.g. 26.1.0

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 berbanding 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, bukannya 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.

Ketidakpadanan sistem koordinat (model kelihatan diputar atau dipantulkan)

Alat yang berbeza menggunakan konvensi yang berbeza (Y-up vs Z-up, tangan kiri vs tangan kanan). Tetapkan ObjLoadOptions.flip_coordinate_system = True atau terapkan putaran pada nod akar Transform 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 jenis.

Soalan Lazim (FAQ)

Format 3D mana yang boleh saya muatkan?

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 .mtl bahan?

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

Bolehkah saya memuatkan fail daripada aliran bait dan bukannya laluan?

Scene.open() menerima rentetan laluan fail. Memuatkan dari aliran dalam memori tidak didedahkan dalam API semasa; tulis bait ke fail sementara terlebih dahulu.

Bagaimana saya dapat normal permukaan?

Selepas memuatkan, periksa mesh.get_element(VertexElementType.NORMAL). Ini mengembalikan satu VertexElementNormal yang data senarai 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 Scene instans daripada benang berasingan adalah selamat selagi anda tidak berkongsi satu Scene merentasi thread tanpa kunci luaran.