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 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 ordre 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 una API de gràfic de escena totalment tipada construïda al voltant de Scene, Node, Entity, Mesh, Camera, Light i Transform, el mateix model conceptual utilitzat per les 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, amb recerca completa), 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.

Compatibilitat amb formats 3D i API de graf de escena tipat

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

On es pot utilitzar Aspose.3D FOSS

  • Pipelines d’actius Node.js: Importa fitxers OBJ, valida i reorienta la geometria, i exporta com a GLB en CI.
  • Eines de joc: Processa per lots malles 3D sense un motor o renderitzador nadiu.
  • 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 segons el format amb classes d’opció.
  • Normalització de normals: Normalitza automàticament les normals dels vèrtexs en carregar o desar.
  • Sortida binària vs. JSON: Selecciona GLB compacte o glTF llegible mitjançant GltfSaveOptions.
  • Control de càrrega de materials: Activa o desactiva la càrrega de MTL/textures per a un anàlisi més ràpid.
  • Fidelitat 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 instal·lacions TypeScript amb una única ordre 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 del 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 dels desenvolupadors, i té llicència MIT amb un gestor d’incidències obert a GitHub.

Carrega una escena OBJ i exporta-la com a glTF

Instal·la amb npm, després utilitza el mètode síncron scene.open() amb ObjLoadOptions per carregar la malla juntament amb el seu fitxer de material MTL. Cridar scene.save() amb una extensió .gltf escriu JSON glTF 2.0 estàndard; 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());

// Exporta com a glTF 2.0 JSON
scene.save("model.gltf");

Converteix STL a GLB binari

Per generar un GLB binari compacte en lloc del glTF JSON per defecte, passa GltfSaveOptions amb binaryMode = true.

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

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

// Desar com a GLB binari compacte
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

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 complements natius de Node.js?

No. Aspose.3D FOSS per a TypeScript és pur JavaScript/TypeScript. 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 et permeten invertir eixos, ajustar l’escala i normalitzar les normals sense codi d’anàlisi 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’integració.

  

Suport i recursos d aprenentatge

 Català