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

Aspose.3D FOSS pour TypeScript

Chargez, construisez, transformez et exportez des scènes 3D depuis Node.js — entièrement typées, open source et prêtes pour la production avec une seule installation npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Documentation GitHub

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

Aspose.3D FOSS for TypeScript est une bibliothèque sous licence MIT pour travailler avec des formats de fichiers 3D dans les applications Node.js. Installez‑la avec une seule commande npm install @aspose/3d et commencez à lire, construire et écrire des scènes 3D en TypeScript immédiatement, sans addons natifs à compiler, sans SDK externes à installer, et sans rendu requis.

La bibliothèque expose une API de graphe de scène entièrement typée construite autour de Scene, Node, Entity, 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 (Wavefront, avec chargement de matériaux .mtl), glTF 2.0 et GLB binaire (matériaux PBR), STL (binaire et ASCII, aller‑retour complet), COLLADA (DAE), 3MF et FBX. Des classes d’options par format telles que ObjLoadOptions et GltfSaveOptions vous offrent un contrôle précis sur l’orientation du système de coordonnées, l’échelle, la normalisation des normales, la sortie binaire vs. JSON, et le chargement des matériaux.

Aspose.3D FOSS cible Node.js 18, 20 et 22+ avec TypeScript 5.0+ et compile en CommonJS. La bibliothèque est livrée avec des paramètres stricts du compilateur TypeScript (noImplicitAny, strictNullChecks) afin que votre IDE fournisse une saisie semi‑automatique complète et une sécurité à la compilation. Sa seule dépendance d’exécution, xmldom, est installée automatiquement. Pour la gamme de produits d’entreprise, voir Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Charger les fichiers Wavefront OBJ avec les définitions de matériaux associées.
  • glTF 2.0 / GLB : Chargement du matériau PBR et sortie binaire GLB via GltfSaveOptions.
  • STL: Lire et écrire les STL binaires et ASCII avec une vérification complète du roundtrip.
  • COLLADA, 3MF, FBX: Prise en charge supplémentaire des formats avec des classes d’options par format.
  • Types TypeScript complets: Chaque classe, méthode et option est fortement typée avec noImplicitAny et strictNullChecks.

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

  • Node.js asset pipelines: Importer des fichiers OBJ, valider et réorienter la géométrie, et exporter en GLB dans le CI.
  • Outils de jeu: Traitement par lots des maillages 3D sans moteur ou rendu natif.
  • Flux de travail d’impression 3D: Lire, valider et réexporter les fichiers STL et 3MF.
  • Back‑ends sans serveur: Exécutez des points de terminaison de conversion 3D dans Lambda ou Cloud Functions.
  • Migration de contenu: Convertir entre les familles de formats à grande échelle à partir d’un seul script.

Options spécifiques à chaque format et contrôle des coordonnées

  • Orientation du système de coordonnées: Inverser les axes et ajuster l’échelle selon le format avec les classes d’options.
  • Normalisation des normales: Normaliser automatiquement les normales des sommets lors du chargement ou de l’enregistrement.
  • Binaire vs. sortie JSON: Sélectionnez GLB compact ou glTF lisible via GltfSaveOptions.
  • Contrôle du chargement des matériaux: Activer ou désactiver le chargement MTL/texture pour une analyse plus rapide.
  • Fidélité du round-trip: Les nœuds de graphe de scène inconnus sont conservés mot pour mot lors du réenregistrement.

Expérience développeur

Aspose.3D FOSS pour TypeScript s’installe avec une seule commande npm install @aspose/3d. Il n’y a aucun module natif à compiler. La bibliothèque est purement TypeScript/JavaScript avec une dépendance auto‑installée (xmldom).

L’API fortement typée fournit une complétion IDE complète pour chaque classe du graphe de scène et chaque option de format. La bibliothèque cible Node.js 18–22+ et TypeScript 5.0+, s’exécute de façon identique sur les runners CI Linux et les stations de travail des développeurs, et est sous licence MIT avec un suivi des problèmes ouvert sur GitHub.

Charger une scène OBJ et Exporter en glTF

Installez avec npm, puis utilisez scene.open() avec ObjLoadOptions pour charger le maillage ainsi que son fichier de matériau MTL. Les deux open() et save() sont synchrones — aucune await ou chaîne de Promises n’est nécessaire. Appeler scene.save() avec une extension .gltf écrit le JSON glTF 2.0 standard — le format est déduit automatiquement de l’extension du fichier.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Convertir STL en GLB binaire

Pour produire un GLB binaire compact au lieu du glTF JSON par défaut, passez GltfSaveOptions avec binaryMode = true. open() et save() sont tous deux synchrones — aucune await n’est nécessaire.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Foire aux questions

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

C’est une bibliothèque TypeScript/Node.js gratuite, sous licence MIT, permettant de charger, manipuler et enregistrer des scènes 3D sans installer d’addon natif ni de SDK externe.

Quels formats 3D sont pris en charge ?

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

Cela requiert-il des modules natifs Node.js ?

N° Aspose.3D FOSS pour TypeScript est du pur JavaScript/TypeScript. Il ne nécessite aucune étape de compilation et possède une seule dépendance d’exécution (xmldom) installée automatiquement par npm.

Comment l’installer ?

Exécutez npm install @aspose/3d. Aucun paquet système supplémentaire ni module natif n’est requis.

Quelles versions de Node.js et de TypeScript sont prises en charge ?

Node.js 18, 20 et 22+. TypeScript 5.0+. La bibliothèque se compile en CommonJS et fonctionne avec des paramètres stricts de TypeScript.

Est-il fourni avec les définitions de types TypeScript ?

Oui. Toutes les classes, méthodes, énumérations et types d’options sont entièrement typés avec noImplicitAny et strictNullChecks activés.

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

Oui. Les classes d’options par format comme ObjLoadOptions et GltfSaveOptions vous permettent d’inverser les axes, d’ajuster l’échelle et de normaliser les normales sans code d’analyse personnalisé.

Où puis-je trouver le code source ?

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