Guide du développeur

Aspose.3D FOSS pour Python est une bibliothèque open-source, sous licence MIT, qui permet aux développeurs Python de charger, construire, transformer et exporter des scènes 3D sans aucune dépendance d’exécution externe. Que vous construisiez une pipeline d’actifs, un outil de validation, un script de traitement géométrique ou un service de conversion de formats, cette bibliothèque offre une API propre et cohérente, soutenue par un modèle de graphe de scène qui reflète les concepts 3D standard de l’industrie.

Ce guide du développeur couvre tout ce dont vous avez besoin pour aller au-delà de l’installation rapide et écrire du code de traitement 3D de qualité production.

Ce que vous trouverez dans cette section

Fonctionnalités et capacités

Le Fonctionnalités la page est la référence principale pour travailler avec Aspose.3D FOSS pour Python. Elle couvre :

  • Prise en charge des formats: OBJ (avec des matériaux .mtl), STL (binaire et ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, et le tokenizer FBX en cours de développement, avec des classes d’options de chargement et d’enregistrement par format.
  • Graphe de scène: Comment Scene, Node, Entity, Transform, et GlobalTransform composer une hiérarchie de scène complète, y compris les modèles de traversée des nœuds enfants.
  • Mesh API: Travailler avec control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, et VertexElementSmoothingGroup pour le traitement géométrique.
  • Système de matériaux: Application LambertMaterial et PhongMaterial aux nœuds de scène, et à la lecture des propriétés de matériau chargées depuis les fichiers .mtl.
  • Utilitaires mathématiques: Utilisation Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, et BoundingBox pour les transformations, les requêtes de boîtes englobantes, et les calculs géométriques.
  • Animation: Construction et lecture AnimationClip, AnimationNode, KeyFrame, et KeyframeSequence données.
  • Charger et enregistrer les options: Classes d’options par format telles que ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Exemples d’utilisation complets: Scripts Python de bout en bout pour charger OBJ, exporter STL, faire un aller-retour glTF, et parcourir les graphes de scène.
  • Conseils, problèmes courants et FAQ: Guide pratique pour éviter les pièges courants en production.
  • Résumé de la référence API: Liste de référence rapide de toutes les classes clés.

Concepts clés

Scene graph: Tout le contenu 3D dans Aspose.3D FOSS est représenté sous forme d’un arbre de Node objets enracinés à scene.root_node. Chaque nœud peut contenir un Entity (tel qu’un Mesh, Camera, ou Light) Transform qui le positionne dans la hiérarchie.

API indépendante du format: Vous ouvrez tout format pris en charge via Scene.open() ou Scene.from_file() et enregistrer dans n’importe quel format pris en charge via Scene.save(). Les mêmes objets de graphe de scène sont utilisés quel que soit le format source ou de destination.

Aucune dépendance: La bibliothèque est pure Python. Il n’y a aucune extension native à compiler, aucun paquet système à installer, et aucune bibliothèque tierce à gérer.

Premiers pas

Si vous n’avez pas encore installé la bibliothèque, consultez le Premiers pas section et le Installation guide avant de poursuivre la lecture.

Sujets disponibles

 Français