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

Aspose.3D FOSS per a TypeScript

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

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

Aprèn GitHub

Biblioteca de TypeScript de codi obert per al processament de fitxers 3D

Aspose.3D FOSS per TypeScript és una biblioteca amb llicència MIT per treballar amb formats de fitxers 3D en aplicacions Node.js. Instal·la-la amb una única comanda npm install @aspose/3d i comença 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 una API de gràfic d’escena totalment tipada construïda 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, sortida binària vs. JSON, i la càrrega de materials.

Aspose.3D FOSS té com a objectiu Node.js 18, 20 i 22+ amb TypeScript 5.0+ i es compila a CommonJS. La biblioteca s’envia amb configuracions estrictes del compilador TypeScript (noImplicitAny, strictNullChecks) perquè el teu 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 empresarial, consulta Aspose.3D — Enterprise Product Family.

Suport per a formats 3D i API de gràfic d’escena tipat

  • OBJ / MTL: Carrega fitxers Wavefront OBJ amb definicions de material adjuntes.
  • glTF 2.0 / GLB: càrrega de material PBR i sortida binària GLB via GltfSaveOptions.
  • STL: Llegeix i escriu tant STL binari com ASCII amb verificació completa de viatge d’anada i tornada.
  • COLLADA, 3MF, FBX: Suport addicional de format amb classes d’opcions per a cada format.
  • Tipus complets de TypeScript: Cada classe, mètode i opció està fortament tipat amb noImplicitAny i strictNullChecks.

On es pot utilitzar Aspose.3D FOSS

  • Node.js asset pipelines: Importa fitxers OBJ, valida i reorienta la geometria, i exporta com a GLB en CI.
  • Eines de joc: Processa en lot malles 3D sense un motor o renderitzador natiu.
  • Fluxos de treball d’impressió 3D: Llegeix, valida i reexporta fitxers STL i 3MF.
  • Backends sense servidor: Executa punts finals de conversió 3D a Lambda o Cloud Functions.
  • Migració de contingut: Converteix entre famílies de formats a gran escala des d’un únic script.

Opcions per format i control de coordenades

  • Orientació del sistema de coordenades: Inverteix els eixos i ajusta l’escala per format amb classes d’opció.
  • Normalització de normals: Normalitza automàticament les normals de vèrtex en carregar o desar.
  • Binari vs. sortida JSON: Seleccioneu GLB compacte o glTF llegible via GltfSaveOptions.
  • Control de càrrega de material: Habilita o deshabilita la càrrega de MTL/textura per a un anàlisi més ràpid.
  • Fidelitat de viatge d’anada i tornada: Els nodes desconeguts del gràfic d’escena es conserven literalment en tornar a desar.

Experiència del desenvolupador

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

L’API fortament tipada ofereix autocompleció completa a l’IDE per a cada classe de gràfic d’escena i opció de format. La biblioteca està dirigida a 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.

Carrega una escena OBJ i exporta-la com a glTF

Instal·la amb npm, després utilitza scene.open() amb ObjLoadOptions per carregar la malla juntament amb el seu fitxer de material MTL. Tant open() com save() són sincrònics — no cal await ni encadenament de Promise. Cridar scene.save() amb una extensió .gltf escriu l’estàndard glTF 2.0 JSON — el format s’infereix automàticament de l’extensió del fitxer.

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");

Converteix STL a GLB binari

Per generar un GLB binari compacte en lloc del JSON glTF per defecte, passa GltfSaveOptions amb binaryMode = true. Tant open() com save() són sincrònics — no cal 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 MIT-licensed de TypeScript/Node.js per carregar, manipular i desar escenes 3D sense instal·lar cap complement natiu ni cap 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 tipada dedicada.

Requereix addons natius de Node.js?

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

Com l’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 es compila a CommonJS i funciona amb configuracions estrictes de TypeScript.

Inclou definicions de tipus de TypeScript?

Sí. Totes les classes, mètodes, enums i tipus d’opcions estan completament tipats amb noImplicitAny i strictNullChecks activats.

Puc controlar l’orientació del sistema de coordenades?

Sí. Les classes d’opcions per format com ObjLoadOptions i GltfSaveOptions us permeten invertir eixos, ajustar l’escala i normalitzar les normals sense codi de parseig personalitzat.

On puc trobar el codi font?

La biblioteca té llicència MIT i està allotjada a GitHub. Es donen la benvinguda els informes d’errors i les sol·licituds d’extracció.

  

Suport i recursos d aprenentatge

 Català