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 pure-Python sous licence MIT pour 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 de 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 spécifique à un format.

Aspose.3D FOSS prend en charge Python 3.7 à 3.12 et s’exécute de manière identique sur Windows, macOS, les runners CI Linux, les conteneurs Docker et les environnements serverless. Pour les fonctionnalités et le support d’entreprise, voir Aspose.3D for Python — Enterprise Product.

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

  • OBJ / MTL: Charger les fichiers Wavefront OBJ avec les définitions de matériaux associées.
  • STL: Lire et écrire les STL binaires et ASCII avec une vérification complète du round‑trip.
  • glTF 2.0 / GLB: Chargement du matériau PBR et sortie binaire GLB via GltfSaveOptions.
  • COLLADA, 3MF, FBX: Prise en charge supplémentaire des formats avec des classes d’options par format.
  • API du 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 dans le CI.
  • Outils de développement de jeux: Traitez 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.
  • Migration de contenu: Convertir entre les 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 : Activez ou désactivez le chargement MTL/texture pour une analyse plus rapide.
  • Binaire vs. sortie JSON : Choisissez GLB compact ou glTF lisible par l’homme via les options.
  • Fidélité du cycle complet: La structure du graphe de scène est maintenue 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 manière 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 packages système à installer.

L’API de graphe de scène reflète le modèle conceptuel des outils 3D professionnels, de sorte que la courbe d’apprentissage est courte pour toute personne familière avec 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 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 une extension .gltf écrit un fichier JSON glTF 2.0 — aucun registre de format ou objet convertisseur nécessaire.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as 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 GltfSaveOptions avec binary_mode = True. Le même schéma 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")
# Save as binary GLB
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. Elle 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 spécifique à un 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