Comment charger des modèles 3D dans Python

Aspose.3D FOSS pour Python fournit une API simple pour ouvrir des fichiers 3D sans aucune dépendance native. Après avoir chargé un fichier dans un Scene objet, vous pouvez parcourir la hiérarchie des nœuds et lire les données de géométrie brute de chaque maillage de la scène.

Guide étape par étape

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)

Problèmes courants et solutions

FileNotFoundError lors de l’appel Scene.from_file()

Le chemin doit être absolu ou correctement relatif au répertoire de travail à l’exécution. Utilisez pathlib.Path pour construire des chemins fiables :

from pathlib import Path
from aspose.threed import Scene

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

mesh.polygons est vide après le chargement d’un fichier STL

Les fichiers STL stockent les triangles sous forme de facettes brutes, pas d’un maillage indexé. Après le chargement, les polygones sont synthétisés à partir de ces facettes. Si polygons apparaît vide, vérifiez len(mesh.control_points); si le nombre est un multiple de 3, la géométrie est stockée sous forme non indexée et chaque triple consécutif de sommets forme un triangle.

Incohérence du système de coordonnées (le modèle apparaît tourné ou reflété)

Différents outils utilisent des conventions différentes (Y-up vs Z-up, main gauche vs main droite). Définissez ObjLoadOptions.flip_coordinate_system = True ou appliquez une rotation au root node’s Transform après le chargement.

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

La liste d’entités d’un nœud peut contenir des entités non maillage (caméras, lumières). Protégez toujours avec isinstance(entity, Mesh) avant le transtypage.

Foire aux questions (FAQ)

Quels formats 3D puis-je charger ?

OBJ (Wavefront), STL (binaire et ASCII), glTF 2.0 / GLB, COLLADA (DAE) et 3MF. La tokenisation des fichiers FBX est partiellement prise en charge, mais l’analyse complète n’est pas encore terminée.

Le chargement d’un fichier OBJ charge-t-il également le .mtl matériau ?

Oui, quand ObjLoadOptions.enable_materials = True (par défaut). La bibliothèque recherche le .mtl fichier dans le même répertoire que le .obj fichier. Si le .mtl est manquant, la géométrie est toujours chargée et un avertissement est émis.

Puis-je charger un fichier à partir d’un flux d’octets au lieu d’un chemin ?

Oui. scene.open() accepte tout objet de type fichier avec un .read() méthode en plus d’une chaîne de chemin de fichier. Passez un flux binaire ouvert (par ex., io.BytesIO) directement. Scene.from_file() n’accepte qu’une chaîne de chemin de fichier.

Comment obtenir les normales de surface ?

Après le chargement, vérifiez mesh.get_element(VertexElementType.NORMAL). Cela renvoie un VertexElementNormal dont data la liste contient un vecteur normal par référence, mappé selon mapping_mode et reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

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

La bibliothèque est-elle thread‑safe pour le chargement de plusieurs fichiers simultanément ?

Chaque Scene objet est indépendant. Charger des fichiers séparés dans des Scene instances provenant de threads séparés est sûr tant que vous ne partagez pas un seul Scene entre les threads sans verrouillage externe.