Kaip įkelti 3D modelius Python kalboje

Aspose.3D FOSS for Python suteikia paprastą API 3D failų atvėrimui be jokių natūralių priklausomybių. Įkėlę failą į Scene objektą, galite naršyti mazgų hierarchiją ir skaityti neapdorotus geometrijos duomenis kiekvienam mesh scenoje.

Žingsnis po žingsnio vadovas

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)

Įprastos problemos ir sprendimai

FileNotFoundError kviestant Scene.from_file()

Kelias turi būti absoliutus arba teisingas santykinis, atsižvelgiant į darbinį katalogą vykdymo metu. Naudokite pathlib.Path patikimiems keliams kurti:

from pathlib import Path
from aspose.threed import Scene

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

mesh.polygons yra tuščias po STL failo įkėlimo

STL failai saugo trikampius kaip neapdorotas plokštumas, o ne indeksuotą tinklą. Įkėlę, daugiakampiai sintezuojami iš tų plokštumų. Jei polygons yra tuščias, patikrinkite len(mesh.control_points); jei skaičius yra 3 kartų kartotinis, geometrija saugoma neindeksuota forma ir kiekviena nuosekliai einanti trijų viršūnių grupė sudaro vieną trikampį.

Koordinačių sistemos nesutapimas (modelis atrodo pasukęs arba veidrodinis)

Skirtingi įrankiai naudoja skirtingas konvencijas (Y‑aukštyje prieš Z‑aukštyje, kairės rankos prieš dešinės rankos). Nustatykite ObjLoadOptions.flip_coordinate_system = True arba pritaikykite sukimosi kampą šaknies mazgo Transform po įkėlimo.

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

Mazgo entiteto sąraše gali būti ne‑mesh entitetų (kamerų, šviesų). Visada naudokite isinstance(entity, Mesh) apsaugą prieš konvertavimą.

Dažnai užduodami klausimai (DUK)

Kuriuos 3D formatus galiu įkelti?

OBJ (Wavefront), STL (binary and ASCII), glTF 2.0 / GLB, COLLADA (DAE) ir 3MF. FBX failų tokenizavimas yra dalinai palaikomas, tačiau pilnas analizavimas dar nebaigtas.

Ar įkeliant OBJ failą taip pat įkeliamas .mtl medžiaga?

Taip, kai ObjLoadOptions.enable_materials = True (numatytasis). Biblioteka ieško .mtl failo toje pačioje kataloge kaip ir .obj failas. Jei .mtl trūksta, geometrija vis tiek įkeliamas ir išduodamas įspėjimas.

Ar galiu įkelti failą iš baitų srauto vietoj kelio?

Taip. scene.open() priima bet kokį failo tipo objektą su .read() metodu, be to, failo kelio eilutę. Perduokite atvirą binarinį srautą (pvz., io.BytesIO) tiesiogiai. Scene.from_file() priima tik failo kelio eilutę.

Kaip gauti paviršiaus normales?

Po įkėlimo patikrinkite mesh.get_element(VertexElementType.NORMAL). Tai grąžina VertexElementNormal, kurio data sąraše yra po vieną normalų vektorių kiekvienai nuorodai, susietą pagal mapping_mode ir reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

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

Ar biblioteka yra gijų saugi (thread‑safe) kelių failų įkėlimui vienu metu?

Kiekvienas Scene objektas yra nepriklausomas. Atskirų failų įkėlimas į atskirus Scene egzempliorius iš atskirų gijų yra saugus, jei nesidalinate vieno Scene tarp gijų be išorinio užrakinimo.