1. Produits
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Python

Aspose.3D FOSS pour Python

Chargez, créez, transformez et exportez des scènes 3D depuis Python — gratuit et open source.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Documentation GitHub

Bibliothèque Python open source pour le traitement de fichiers 3D

Aspose.3D FOSS pour Python est une bibliothèque sous licence MIT, pure-Python, destinée à travailler avec les formats de fichiers 3D. Installez‑la avec une seule commande pip et commencez immédiatement à lire, construire et écrire des scènes 3D sans installer aucun runtime natif, SDK externe ou moteur de rendu tiers.

La bibliothèque expose une API de graphe de scène propre, construite autour de Scene, Node, Mesh, Camera, Light et Transform, le même modèle conceptuel utilisé par les outils 3D professionnels. La prise en charge des formats comprend OBJ (avec chargement des matériaux .mtl), STL (binaire et ASCII, vérifié en aller‑retour), glTF 2.0 / GLB (matériaux PBR), COLLADA (DAE), 3MF et FBX. Les options de chargement et d’enregistrement par format vous permettent de contrôler le retournement des coordonnées, l’échelle, la normalisation des normales et le chargement des matériaux sans écrire de code d’analyse propre à chaque format.

Aspose.3D FOSS prend en charge Python 3.7 à 3.12 et s’exécute de façon identique sur les runners CI Windows, macOS et Linux, les conteneurs Docker et les environnements serverless. Il n’y a aucune extension native à compiler et aucun paquet système à installer.

Prise en charge des formats 3D et API de graphe de scène

  • OBJ / MTL : Chargez les fichiers Wavefront OBJ avec leurs définitions de matériaux associées.
  • STL : Lisez et écrivez les fichiers STL binaires et ASCII avec une vérification complète en aller‑retour.
  • glTF 2.0 / GLB : Chargement de matériaux PBR et sortie GLB binaire via GltfSaveOptions.
  • COLLADA, 3MF, FBX : Prise en charge supplémentaire des formats avec des classes d’options par format.
  • API de graphe de scène : Scene, Node, Mesh, Camera, Light, Transform.

Où Aspose.3D FOSS peut être utilisé

  • Pipelines de validation des actifs: Vérifier, réorienter et réexporter les actifs 3D en CI.
  • Outils de développement de jeux: Traiter par lots les maillages OBJ/GLB sans moteur natif.
  • Flux de travail d’impression 3D: Lire, valider et réexporter les fichiers STL et 3MF.
  • Web backends : Servir des points de terminaison de conversion 3D dans Docker ou des fonctions serverless.
  • Content migration : Convertir entre des familles de formats à grande échelle.

Options par format et contrôle des coordonnées

  • Orientation du système de coordonnées: Inverser les axes et ajuster l’échelle selon le format sans code personnalisé.
  • Normalisation des normales: Normaliser automatiquement les normales des sommets lors du chargement ou de l’enregistrement.
  • Contrôle du chargement des matériaux: Activer ou désactiver le chargement des fichiers MTL/texture pour accélérer l’analyse.
  • Sortie binaire vs. JSON: Choisir GLB compact ou glTF lisible par l’homme via les options.
  • Fidélité en aller-retour: La structure du graphe de scène est conservée lors des cycles de chargement et d’enregistrement (la fidélité de préservation des nœuds dépend du format et n’est pas vérifiée de façon indépendante pour tous les formats).

Expérience développeur

Aspose.3D FOSS pour les installations Python avec une seule commande pip install aspose-3d-foss. La bibliothèque est pure Python, sans extensions natives à compiler et sans paquets système à installer.

L’API du graphe de scène reflète le modèle conceptuel des outils 3D professionnels, de sorte que la courbe d’apprentissage est courte pour quiconque connaît le modèle de données de Three.js ou de Blender. La bibliothèque est sous licence MIT, open source, et accueille les rapports de bugs ainsi que les contributions sur GitHub.

Charger une scène OBJ et l’exporter en glTF

Installez avec pip, puis appelez Scene.open() avec ObjLoadOptions pour charger le fichier OBJ ainsi que ses définitions de matériaux MTL. Un seul appel scene.save() avec l’extension .gltf écrit un fichier JSON glTF 2.0, sans registre de formats ni objet convertisseur requis.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

# Charger un fichier OBJ (avec des matériaux .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Exporter en glTF 2.0
scene.save("model.gltf")

Convertir STL en GLB binaire avec inversion des coordonnées

Pour produire un GLB binaire compact au lieu du glTF JSON par défaut, passez une instance de GltfSaveOptions avec binary_mode = True. Le même principe s’applique aux ajustements du système de coordonnées — remplacez la classe d’options par le format que vous ciblez.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions

scene = Scene()
scene.open("mesh.stl")

# Enregistrer en GLB binaire
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Foire aux questions

Qu’est-ce que Aspose.3D FOSS pour Python ?

C’est une bibliothèque pure-Python gratuite, sous licence MIT, pour charger, manipuler et enregistrer des scènes 3D sans installer de runtime natif ni de SDK externe.

Quels formats 3D sont pris en charge ?

OBJ (avec .mtl), STL (binaire et ASCII), glTF 2.0 et GLB, COLLADA (DAE), 3MF et FBX. Chaque format possède une classe d’options de chargement/enregistrement dédiée.

Cela nécessite-t-il des dépendances natives ?

Non. Aspose.3D FOSS pour Python est pure Python sans aucune extension native. Il fonctionne sous Windows, macOS et Linux sans aucune étape de compilation.

Comment l’installer ?

Exécutez pip install aspose-3d-foss. Aucun paquet système supplémentaire ni extension native n’est requis.

Puis-je contrôler l’orientation du système de coordonnées ?

Oui. Les classes d’options par format vous permettent d’inverser les axes, d’ajuster l’échelle et de normaliser les normales sans écrire de code d’analyse propre à chaque format.

Quelles versions de Python sont prises en charge ?

Python 3.7 à 3.12 sont pris en charge. La bibliothèque fonctionne de manière identique sur tous les principaux systèmes d’exploitation.

Le code source est-il disponible ?

Oui. La bibliothèque est sous licence MIT et hébergée sur GitHub. Les rapports de bugs et les pull requests sont les bienvenus.

  

Ressources de support et d'apprentissage

 Français