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é, open‑source et prêt 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 un API de graphe de scène entièrement typé construit 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 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. Pour la gamme de produits d’entreprise, voir Aspose.3D — Enterprise Product Family.

Prise en charge du format 3D et API de graphique scène typé

  • ** OBJ/MTL:** Charger les fichiers OB J de Wavefront avec des définitions du matériel qui s’y rattachent.
  • glTF 2.0 / GLB: Chargement du matériau PBR et sortie en double de la GDB par l’intermédiaire de GltfSaveOptions.
  • STL: Lire et écrire à la fois STL binaire ou ASCII avec une vérification complète aller-retour.
  • COLLADA, 3MF, FBX: Support supplémentaire des formats avec les classes d’options par format.
  • Types de type script complet: 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, et exporter comme GLB dans CI.
  • Outils de jeu: Maillots 3D en lot sans moteur ou rendering natif.
  • Flues de travail d’impression 3D: Lire, valider et réexporter les fichiers STL et 3MF.
  • ** Backends sans serveur:** Exécutez des points de conversion 3D dans Lambda ou Cloud Functions.
  • Migration de contenu: Convertir entre les familles de formats à l’échelle d’un seul script.

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 avec des classes d’option.
  • Normalization normale: Normalize automatiquement les normaux de sommet lors du chargement ou de l’enregistrement.
  • Suivi de la commande binary contre JSON: Sélectionnez GLB compact ou glTF lisible via GltfSaveOptions.
  • ** Contrôle du chargement des matériaux:** Activer ou désactimer le charging MTL/textures pour une analyse plus rapide.
  • Fidélité aller-retour: Les nœuds de scène-graphe inconnus sont conservés littéralement lors du réenregistrement.

Expérience de 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 pure TypeScript/JavaScript avec une dépendance auto‑installée (xmldom).

Le API fortement typé fournit une complétion IDE complète pour chaque classe de scene-graph 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 l’exporter en glTF

Installez avec npm, puis utilisez scene.open() avec ObjLoadOptions pour charger le maillage avec son fichier de matériau MTL. Les deux open() et save() sont synchrones — aucune await ou chaînage de Promise 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. Les deux open() et save() sont synchrones pas besoin de await.

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 le type de texte ?

Il s’agit d’une bibliothèque TypeScript/Node.js gratuite sous licence MIT pour le chargement, la manipulation et l’enregistrement de scènes 3D sans installer aucun addon natif ou SDK externe.

Quels formats 3D sont pris en charge ?

Le format est composé de plusieurs options: OBJ (avec .mtl), glTF 2.0 et GLB, STL (binary et ASCII), COLLADA (DAE), 3MF et FBX. Chaque format a une classe d’options typées dédiée.

Est-ce que cela nécessite des addons natifs Node.js ?

Non. Aspose.3D FOSS pour TypeScript est un JavaScript/TypeScript pur. Il ne nécessite aucune étape de compilation et dispose d’une seule dépendance en temps d ’exécution (xmldom) installée automatiquement par npm.

Comment l’installer ?

Exécutez npm install @aspose/3d. Aucun paquet système supplémentaire ou module 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 est compilée en CommonJS et fonctionne avec des paramètres de type script stricts.

Est-ce que cela est livré avec des définitions de type TypeScript?

Oui. Toutes les classes, méthodes, enums et types d’options sont entièrement saisis avec noImplicitAny et strictNullChecks activé.

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

Oui. Les classes d’options par format telles que ObjLoadOptions et GltfSaveOptions vous permettent de faire pivoter les axes, ajuster l’échelle et 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 demandes d’extraction sont bienvenus.

  

Ressources de support et d'apprentissage

 Français