3D modellek betöltése Pythonban

Aspose.3D FOSS for Python egyszerű API-t biztosít 3D fájlok megnyitásához, anélkül, hogy natív függőségek lennének. Egy fájl betöltése után egy Scene objektumba, bejárhatja a csomópont-hierarchiát, és nyers geometriai adatokat olvashat a jelenet minden hálójáról.

Lépésről‑lépésre útmutató

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)

Gyakori problémák és megoldások

FileNotFoundError a Scene.from_file() hívásakor

Az elérési útnak abszolútnak vagy a futási időben a munkakönyvtárhoz képest helyes relatívnak kell lennie. Használja a pathlib.Path‑t megbízható utak építéséhez:

from pathlib import Path
from aspose.threed import Scene

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

mesh.polygons üres az STL fájl betöltése után

Az STL fájlok háromszögeket nyers felületekként tárolják, nem indexelt hálóként. Betöltés után a poligonok ezekből a felületekből szintetizálódnak. Ha polygons üresnek jelenik meg, ellenőrizze len(mesh.control_points); ha a szám 3‑mal osztható, akkor a geometria nem indexelt formában van tárolva, és minden egymást követő három csúcs egy háromszöget alkot.

Koordináta‑rendszer eltérés (a modell elfordult vagy tükrözöttnek tűnik)

Különböző eszközök különböző konvenciókat használnak (Y-felfelé vs Z-felfelé, balkezes vs jobbkezes). Állítsa be ObjLoadOptions.flip_coordinate_system = True vagy alkalmazzon egy forgatást a gyökércsomópont Transform-jára a betöltés után.

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

Egy csomópont entitáslistája tartalmazhat nem‑mesh entitásokat (kamerákat, fényeket). Mindig védd isinstance(entity, Mesh)-vel a konvertálás előtt.

Gyakran Ismételt Kérdések (GYIK)

Milyen 3D formátumokat tölthetek be?

OBJ (Wavefront), STL (bináris és ASCII), glTF 2.0 / GLB, COLLADA (DAE) és 3MF. Az FBX fájl tokenizálása részben támogatott, de a teljes elemzés még nem készült el.

Az OBJ fájl betöltése is betölti a .mtl anyagot?

Igen, amikor ObjLoadOptions.enable_materials = True (az alapértelmezett). A könyvtár a .mtl fájlt keresi ugyanabban a könyvtárban, mint a .obj fájl. Ha a .mtl hiányzik, a geometria továbbra is betöltődik, és figyelmeztetés jelenik meg.

Betölthetek egy fájlt bájtfolyamból az útvonal helyett?

Igen. scene.open() elfogad bármilyen fájl-szerű objektumot egy .read() metódussal a fájlútvonal karakterlánc mellett. Adjon át egy nyitott bináris adatfolyamot (például io.BytesIO) közvetlenül. Scene.from_file() csak egy fájlútvonal karakterláncot fogad el.

Hogyan kapok felületi normálvektorokat?

Betöltés után ellenőrizze a mesh.get_element(VertexElementType.NORMAL)-t. Ez egy VertexElementNormal-t ad vissza, amelynek data listája minden hivatkozáshoz egy normálvektort tartalmaz, a mapping_mode és reference_mode szerint leképezve.

from aspose.threed.entities import Mesh, VertexElementType

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

A könyvtár szálbiztos a több fájl egyidejű betöltéséhez?

Minden Scene objektum független. Különálló fájlok betöltése különálló Scene példányokba külön szálakról biztonságos, amíg nem oszt meg egyetlen Scene‑t szálak között külső zárolás nélkül.