Ako načítať 3D modely v Python

Aspose.3D FOSS pre Python poskytuje jednoduché API na otváranie 3D súborov bez akýchkoľvek natívnych závislostí. Po načítaní súboru do Scene objektu môžete prechádzať hierarchiu uzlov a čítať surové geometrické dáta pre každú sieť v scéne.

Postupný návod

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)

Bežné problémy a riešenia

FileNotFoundError pri volaní Scene.from_file()

Cesta musí byť absolútna alebo správne relatívna k pracovnému adresáru v čase behu. Použite pathlib.Path na vytvorenie spoľahlivých ciest:

from pathlib import Path
from aspose.threed import Scene

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

mesh.polygons je prázdny po načítaní súboru STL

STL súbory ukladajú trojuholníky ako surové fasety, nie ako indexovanú sieť. Po načítaní sa polygóny syntetizujú z týchto fasiet. Ak polygons vyzerá prázdny, skontrolujte len(mesh.control_points); ak je počet násobkom 3, geometria je uložená v neindexovanej forme a každá po sebe nasledujúca trojica vrcholov tvorí jeden trojuholník.

Nesúlad súradnicového systému (model sa javí otočený alebo zrkadlený)

Rôzne nástroje používajú rôzne konvencie (Y-up vs Z-up, ľavá ruka vs pravá ruka). Nastavte ObjLoadOptions.flip_coordinate_system = True alebo aplikovať rotáciu na koreňového uzla Transform po načítaní.

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

Zoznam entít uzla môže obsahovať ne‑mesh entity (kamery, svetlá). Vždy chráňte pomocou isinstance(entity, Mesh) pred pretypovaním.

Často kladené otázky (FAQ)

Ktoré 3D formáty môžem načítať?

OBJ (Wavefront), STL (binárny a ASCII), glTF 2.0 / GLB, COLLADA (DAE) a 3MF. Tokenizácia FBX súborov je čiastočne podporovaná, ale úplné parsovanie ešte nie je dokončené.

Načíta sa pri načítaní OBJ súboru aj .mtl materiál?

Áno, keď ObjLoadOptions.enable_materials = True (predvolené). Knižnica hľadá .mtl súbor v rovnakom adresári ako .obj súbor. Ak .mtl chýba, geometria sa stále načíta a je vydané varovanie.

Môžem načítať súbor z bajtového prúdu namiesto cesty?

Áno. scene.open() akceptuje akýkoľvek objekt podobný súboru s .read() metódou okrem reťazca cesty k súboru. Odovzdajte otvorený binárny prúd (napr., io.BytesIO) priamo. Scene.from_file() akceptuje iba reťazec cesty k súboru.

Ako získam normály povrchu?

Po načítaní skontrolujte mesh.get_element(VertexElementType.NORMAL). Toto vracia VertexElementNormal ktorého data zoznam obsahuje jeden normálny vektor na referenciu, mapovaný podľa mapping_mode a reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

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

Je knižnica vláknovo bezpečná pri načítavaní viacerých súborov súčasne?

Každý Scene objekt je nezávislý. Načítanie samostatných súborov do samostatných Scene inštancie z oddelených vlákien je bezpečné pokiaľ nesdielate jediný Scene naprieč vláknami bez externého zamykania.