Premiers pas

Aspose.3D FOSS pour Python

Bienvenue à Aspose.3D FOSS pour Python, une bibliothèque gratuite, sous licence MIT, pour charger, construire et exporter des scènes 3D depuis Python. Ce guide vous fera passer d’un environnement vierge à une scène fonctionnelle en quelques minutes.

Prérequis

Avant l’installation, assurez-vous que votre environnement répond à ces exigences :

Python Version

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython est l’interpréteur de référence ; les six versions sont testées à chaque publication.

Gestionnaire de paquets

  • pip (fourni avec toutes les installations modernes de Python)
  • Aucun autre outil de construction, compilateur ou paquet système n’est requis.

Système d’exploitation

  • Windows, macOS et Linux sont tous pris en charge.
  • La bibliothèque est pure Python : aucune extension native spécifique à la plateforme à compiler.

Installation

Installez depuis PyPI avec pip :

pip install aspose-3d-foss

Voir le Guide d’installation pour la configuration d’un environnement virtuel, les étapes de vérification et un exemple de code de démarrage rapide.

Aspose.3D FOSS pour Python

Une fois installé, vous pouvez immédiatement :

  • Charger fichiers OBJ (avec prise en charge des matériaux .mtl), STL, glTF 2.0, GLB, COLLADA et 3MF
  • Inspecter hiérarchies de scènes : parcourir les nœuds, lire les maillages, accéder aux normales de sommet et aux UVs
  • Transform scènes : appliquer les positions, les rotations (via Quaternion), et les échelles en utilisant Transform
  • Appliquer les matériaux: travailler avec LambertMaterial et PhongMaterial sur les nœuds de scène
  • Exporter vers n’importe quel format pris en charge avec des options d’enregistrement propres à chaque format
  • Calculer la géométrie: interroger les boîtes englobantes, accumuler les transformations en espace mondial avec GlobalTransform
  • Lire l’animation: accéder AnimationClip et KeyframeSequence données provenant des fichiers glTF et COLLADA chargés

Démarrage rapide

Le code suivant charge un fichier de scène, affiche les enfants du nœud racine et enregistre à nouveau la scène au format GLB :

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Étapes suivantes

 Français