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

Aspose.3D FOSS for TypeScript

Carrega, construeix, transforma i exporta escenes 3D des de Node.js — totalment tipat, de codi obert i llest per a producció amb una sola instal·lació npm.

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

Aprèn GitHub

Biblioteca de fonts obertes TypeScript per a processament de fitxers 3D

Aspose.3D FOSS per a TypeScript és una biblioteca amb llicència MIT per treballar amb formats de fitxers 3D en aplicacions Node.js. Instal·leu-la amb una única comanda npm install @aspose/3d i comenceu a llegir, construir i escriure escenes 3D en TypeScript immediatament, sense complements natius per compilar, sense SDK externs per instal·lar i sense necessitat de renderitzador.

La biblioteca exposa un API de gràfic d’escena completament tipat construït al voltant de Scene, Node, Entity, Mesh, Camera, Light i Transform, el mateix model conceptual utilitzat per eines 3D professionals. El suport de formats inclou OBJ (Wavefront, amb càrrega de materials .mtl), glTF 2.0 i GLB binari (materials PBR), STL (binari i ASCII, recorregut complet), COLLADA (DAE), 3MF i FBX. Classes d’opcions per format com ObjLoadOptions i GltfSaveOptions us ofereixen un control precís sobre l’orientació del sistema de coordenades, l’escala, la normalització de normals, la sortida binària vs. JSON, i la càrrega de materials.

Aspose.3D FOSS s’adreça a Node.js 18, 20 i 22+ amb TypeScript 5.0+ i es compila a CommonJS. La biblioteca ve amb configuracions estrictes del compilador TypeScript (noImplicitAny, strictNullChecks) perquè el vostre IDE ofereixi autocompleció completa i seguretat en temps de compilació. La seva única dependència d’execució, xmldom, s’instal·la automàticament. Per a la família de productes empresarials, vegeu Aspose.3D — Enterprise Product Family.

Suport al format 3D i API de gràfics d’escena tipitzats

  • ** OBJ / MTL:** Carregar els arxius Wavefront OB J amb les definicions de material que l’acompanyen.
  • glTF 2.0 / GLB: Carrega de material PBR i sortida binària de GDB a través d’ GltfSaveOptions.
  • STL: Llegir i escriure STL binari i ASCII amb verificació completa de tornada.
  • COLLADA, 3MF, FBX: Suport de formats addicionals amb classes d’opció per format.
  • Tipes de TypeScript complet: Cada classe, mètode i opció està fortament mecanitzada amb noImplicitAny i strictNullChecks.

On Aspose.3D es pot utilitzar FOSS

  • Node.js asset pipelines: Importeu arxius OBJ, valideu i reorienteu la geometria, i exportau com GLB en CI.
  • Oferta de joc: Maixes 3D processades en batxes sense motor o render natiu.
  • Flusos de treball d’impressió 3D: Llegir, validar i reexporter arxius STL i 3MF.
  • ** Servidor sense backends:** Exercir punts de conversió 3D en Lambda o Cloud Functions.
  • Migració de contingut: Convertir entre famílies de formats a escala des d’un sol script.

Opcions de format i control de coordenades

  • Orientació del sistema de coordenades: Flip axes i ajustar l’escala per format amb classes d’opció.
  • Normalització normal: Normalitzar automàticament les normatives de vèrtex en càrrega o salvament.
  • Suportació binària vs. JSON: Selecciona GLB compacte o glTF llegible a través de GltfSaveOptions.
  • Control de càrrega del material: Habilitar o desactivar la càrrega MTL/textura per a un parseig més ràpid.
  • Fidelitat de tornada: Els nodes desconeguts en la escena-graf es conserven literalment a l’encàrrec.

Experiència de desenvolupador

Aspose.3D FOSS per a instal·lacions de TypeScript amb una sola comanda npm install @aspose/3d. No hi ha cap complement natiu per compilar. La biblioteca és pur TypeScript/JavaScript amb una dependència auto‑instal·lada (xmldom).

El API fortament tipat ofereix autocompleció completa a l’IDE per a cada classe de gràfic d’escena i opció de format. La biblioteca té com a objectiu Node.js 18–22+ i TypeScript 5.0+, s’executa de manera idèntica en runners CI de Linux i estacions de treball de desenvolupadors, i té llicència MIT amb un rastrejador d’incidències obert a GitHub.

Carregar una escena OBJ i exportar com a glTF

Instal·lar amb npm, després utilitzar scene.open() amb ObjLoadOptions per carregar la malla juntament amb el seu fitxer de material MTL. Tant open() com save() són sincrones no es necessita l’enllaç d’await o Promesa . Llamar a scene.save() Amb una extensió .gltf escriu glTF JSON 2.0 estàndard ?? el format s’inverteix automàticament des de l ’extensió del fitxatge.

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 binari

Per produir un GLB binari compacte en lloc del JSON glTF predeterminat, passa GltfSaveOptions amb binaryMode = true. Tant open() com save() són sincrones no es necessita 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);

Preguntes freqüents

Què és Aspose.3D FOSS per a TypeScript?

És una biblioteca gratuïta, amb llicència MIT TypeScript/Node.js per a carregar, manipular i guardar escenes 3D sense instal·lar cap addon natiu o SDK extern.

Quins formats 3D són compatibles?

OBJ (amb .mtl), glTF 2.0 i GLB, STL (binari i ASCII), COLLADA (DAE), 3MF i FBX. Cada format té una classe d’opcions tipades dedicada.

Requereix addons natius de Node.js?

No. Aspose.3D FOSS per TypeScript és JavaScript/TypeScript pur. No requereix pas de compilació i té una dependència d’executament única (xmldom) instal·lada automàticament per npm.

Com ho instal·lo?

Executeu npm install @aspose/3d. No es requereixen paquets de sistema addicionals ni complements natius.

Quines versions de Node.js i TypeScript són compatibles?

Node.js 18, 20 i 22+. TypeScript 5.0+. La biblioteca compila a CommonJS i treballa amb estrictes configuracions de Type Script.

Es fa servir amb definicions de tipus TypeScript?

Sí. Totes les classes, mètodes, enums i tipus d’opció estan totalment digitats amb noImplicitAny i strictNullChecks activades.

Puc controlar l’orientació del sistema de coordenades?

Sí. Les classes d’opció per format com ObjLoadOptions i GltfSaveOptions et permeten girar els eixos, ajustar l’escala i normalitzar les normes sense codi de parseig personalitzat.

On puc trobar el codi font?

La biblioteca està llicenciada pel MIT i allotjada a GitHub. Les informacions de bugs i les sol·licituds d’extracció són benvingudes.

  

Suport i recursos d aprenentatge

 Català