Guide du développeur

Aspose.3D FOSS for TypeScript est une bibliothèque open-source sous licence MIT qui permet aux développeurs Node.js de charger, construire, transformer et exporter des scènes 3D avec une sécurité de type complète en TypeScript. Que vous construisiez une chaîne d’outils d’actifs, un service de conversion de formats, un outil de validation de géométrie ou un script d’auteur de contenu 3D, 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 TypeScript. Elle couvre :

  • Prise en charge des formats: OBJ (avec des matériaux .mtl), glTF 2.0 / GLB binaire, STL (binaire et ASCII), COLLADA (DAE), 3MF et FBX, avec des classes d’options de chargement et d’enregistrement par format incluant ObjLoadOptions et GltfSaveOptions.
  • Graphe de scène: Comment Scene, Node, Entity, Transform, et SceneObject se composent en une hiérarchie de scène complète, incluant des schémas de traversée des nœuds enfants.
  • API de géométrie et de maillage: Travailler avec Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, et ReferenceMode pour le traitement géométrique.
  • Système de matériaux: Appliquer LambertMaterial, PhongMaterial, et PbrMaterial (PBR pour glTF) aux nœuds de scène, et lire les propriétés des matériaux chargées à partir de fichiers .mtl.
  • Utilitaires mathématiques: Utiliser Vector3, Vector4, Matrix4, Quaternion, et BoundingBox pour les transformations, les requêtes de boîtes englobantes et les calculs géométriques.
  • Animation: Construction et lecture AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, et Extrapolation données.
  • Prise en charge des flux et des tampons: Chargement de scènes 3D depuis la mémoire Buffer objets via scene.openFromBuffer() pour les cas d’utilisation serverless et de streaming.
  • Exemples d’utilisation complets: Scripts TypeScript de bout en bout pour charger OBJ, exporter GLB, faire un aller-retour STL, et parcourir les graphes de scène.
  • Conseils, problèmes courants et FAQ: Conseils pratiques pour éviter les pièges courants en utilisation en production.
  • Résumé de la référence API: Liste de référence rapide de toutes les classes clés et de leurs méthodes principales.

Concepts clés

Graphe de scène: Tout le contenu 3D dans Aspose.3D FOSS est représenté sous forme d’un arbre de Node objets enracinés à scene.rootNode. 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 n’importe quel format pris en charge via scene.open() ou scene.openFromBuffer() et enregistrez dans n’importe quel format pris en charge via scene.save(). Les mêmes objets du graphe de scène sont utilisés quel que soit le format source ou de destination.

Typage TypeScript strict: La bibliothèque est fournie avec des paramètres de compilateur stricts (noImplicitAny, strictNullChecks) et des définitions de types complètes. Chaque classe, méthode et propriété d’option est entièrement typée, vous offrant l’autocomplétion de l’IDE et la sécurité à la compilation tout au long de votre code de traitement 3D.

Dépendance unique: La seule dépendance d’exécution est xmldom, qui est installé automatiquement par npm. Il n’y a aucun module natif à compiler et aucun paquet système à installer.

Premiers pas

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

Les sujets disponibles

 Français