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

Aspose.3D FOSS for 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, 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 un API de graphe de scène propre construit 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 façon identique sur les runners CI Windows, macOS et 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 du format 3D et l’API Scene-Graph

  • OBJ / MTL: Chargez les fichiers Wavefront OBJ avec les définitions de matériaux associées.
  • STL: Lisez et écrivez les STL binaires et ASCII avec une vérification complète du cycle complet.
  • glTF 2.0 / GLB: Chargement de matériaux PBR et sortie GLB binaire via GltfSaveOptions.
  • COLLADA, 3MF, FBX: Prise en charge supplémentaire de formats avec des classes d’options par format.
  • Scene-graph API: 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 actif 3D dans le CI.
  • Outils de développement du jeu: Maillots OBJ/GLB sans moteur natif.
  • Flues de travail d’impression 3D: Lire, valider et réexporter les fichiers STL et 3MF.
  • ** Backends Web:** Servir les points de conversion 3D dans Docker ou des fonctions sans serveur.
  • Migration de contenu: Conversion entre familles de formats à grande échelle.

Options de format et contrôle des coordonnées

  • ** Orientation du système de coordonnées:** Faites pivoter les axes et ajustez l’échelle par format sans code personnalisé.
  • Normalization normale: Normalize automatiquement les normaux de sommet lors du chargement ou de l’enregistrement.
  • ** Contrôle du chargement des matériaux:** Activer ou désactimer le charging MTL/textures pour une analyse plus rapide.
  • Suivi de la sortie JSON: Choisissez GLB compact ou glTF lisible par l’homme via les options.
  • Fidélité aller-retour: La structure du graphique de scène est maintenue à travers les cycles de chargement et d’enregistrement (la fidélité de la préservation des nœuds dépend du format et n’est pas vérifiée indépendamment pour tous les formats).

Expérience de développeur

Aspose.3D FOSS pour Python s’installe 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.

Le scene-graph API 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ériel MTL. Un seul appel scene.save() avec une extension .gltf écrit un fixier JSON glTF 2.0 pas besoin d’un registre ou d ‘objets convertisseurs de format.

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 le retournement de coordonnées

Pour produire un GLB binaire compact au lieu du JSON glTF par défaut, passez une instance GltfSaveOptions avec binary_mode = True. Le même modèle s’applique aux ajustements de système de coordonnées échangez la classe d’options pour 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 ?

Il s’agit d’une bibliothèque Python pure et gratuite sous licence MIT pour le chargement, la manipulation et l’enregistrement de scènes 3D sans installer aucun SDK externe ou native.

Quels formats 3D sont pris en charge ?

Les formats suivants sont les plus couramment utilisés: OBJ (avec .mtl), STL (binary et ASCII), glTF 2.0 et GLB, COLLADA (DAE), 3MF et FBX. Chaque format a une classe d’options de chargement / sauvegarde dédiée.

Est-ce que cela nécessite des dépendances natives ?

Non. Aspose.3D FOSS pour Python est un Python pur avec zéro extensions natives. Il fonctionne sur 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 ou extension native n’est requis.

Je peux contrôler l’orientation du système de coordonnées ?

Les classes d’options par format vous permettent de faire pivoter les axes, ajuster l’échelle et normaliser les normales sans écrire aucun code d"analyse spécifique au 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 ?

La bibliothèque est sous licence MIT et hébergée sur GitHub. Les rapports de bugs et les demandes d’extraction sont bienvenus.

  

Ressources de support et d'apprentissage

 Français