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

Aspose.3D FOSS for 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 pour 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, cycle complet), COLLADA (DAE), 3MF et FBX. Des classes d’options spécifiques à chaque 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 se compile en CommonJS. La bibliothèque est livrée avec des paramètres stricts du compilateur TypeScript (noImplicitAny, strictNullChecks) afin que votre IDE offre une complétion automatique complète et une sécurité à la compilation. Sa seule dépendance d’exécution, xmldom, est installée automatiquement.

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

  • OBJ / MTL : Chargez les fichiers Wavefront OBJ avec les définitions de matériaux associées.
  • glTF 2.0 / GLB : Chargement de matériaux PBR et sortie GLB binaire via GltfSaveOptions.
  • STL : Lisez et écrivez les fichiers STL binaires et ASCII avec une vérification complète du cycle.
  • COLLADA, 3MF, FBX : Prise en charge supplémentaire des formats avec des classes d’options spécifiques à chaque 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é

  • Pipelines d’actifs Node.js : Importer des fichiers OBJ, valider et réorienter la géométrie, puis exporter en GLB dans le CI.
  • Outils de jeu : Traiter 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 : Convertissez entre des 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.
  • Sortie binaire vs. JSON : Sélectionner le GLB compact ou le glTF lisible via GltfSaveOptions.
  • Contrôle du chargement des matériaux : Activer ou désactiver le chargement des fichiers MTL/texture pour un parsing plus rapide.
  • Fidélité en aller-retour : Les nœuds inconnus du graphe de scène sont conservés mot pour mot lors du réenregistrement.

Expérience développeur

Aspose.3D FOSS pour les installations TypeScript 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 offre une complétion complète dans l’IDE 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 système de suivi des problèmes ouvert sur GitHub.

Charger une scène OBJ et l’exporter au format glTF

Installez avec npm, puis utilisez la méthode synchrone scene.open() avec ObjLoadOptions pour charger le maillage ainsi que son fichier de matériau MTL. Appeler scene.save() avec une extension .gltf écrit du 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());

// Exporter en JSON glTF 2.0
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.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Enregistrer en GLB binaire compact
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, pour charger, manipuler et enregistrer des scènes 3D sans installer d’addon natif ou 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 nécessite-t-il des modules natifs Node.js ?

Non. 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 addon natif n’est requis.

Quelles versions de Node.js et 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 livré avec des 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. Des 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