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

Aspose.3D FOSS pentru TypeScript

Încarcă, construiește, transformă și exportă scene 3D din Node.js — complet tipizate, open-source și pregătite pentru producție cu o singură instalare npm.

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

Documentation GitHub

Bibliotecă open-source TypeScript pentru procesarea fișierelor 3D

Aspose.3D FOSS pentru TypeScript este o bibliotecă licențiată MIT pentru lucrul cu formate de fișiere 3D în aplicații Node.js. Instalați-o cu o singură comandă npm install @aspose/3d și începeți să citiți, să construiți și să scrieți scene 3D în TypeScript imediat, fără addon-uri native de compilat, fără SDK-uri externe de instalat și fără a necesita un renderer.

Biblioteca expune un API de graf de scenă complet tipizat, construit în jurul claselor Scene, Node, Entity, Mesh, Camera, Light și Transform, același model conceptual utilizat de instrumentele 3D profesionale. Suportul pentru formate include OBJ (Wavefront, cu încărcare de materiale .mtl), glTF 2.0 și GLB binar (materiale PBR), STL (binar și ASCII, cu verificare completă a ciclului), COLLADA (DAE), 3MF și FBX. Clasele de opțiuni per-format, cum ar fi ObjLoadOptions și GltfSaveOptions, vă oferă control precis asupra orientării sistemului de coordonate, scalării, normalizării normelor, ieșirii binare vs. JSON și încărcării materialelor.

Aspose.3D FOSS vizează Node.js 18, 20 și 22+ cu TypeScript 5.0+ și compilează în CommonJS. Biblioteca este livrată cu setări stricte ale compilatorului TypeScript (noImplicitAny, strictNullChecks), astfel încât IDE‑ul dvs. să ofere completare automată completă și siguranță la compilare. Singura dependență la runtime, xmldom, este instalată automat.

Suport pentru formate 3D și API tipizat pentru graficul de scenă

  • OBJ / MTL: Încarcă fișiere Wavefront OBJ cu definițiile de materiale aferente.
  • glTF 2.0 / GLB: Încărcare de materiale PBR și ieșire binară GLB prin GltfSaveOptions.
  • STL: Citește și scrie atât STL binar, cât și ASCII, cu verificare completă a ciclului.
  • COLLADA, 3MF, FBX: Suport suplimentar pentru formate cu clase de opțiuni per-format.
  • Tipuri TypeScript complete: Fiecare clasă, metodă și opțiune este puternic tipizată cu noImplicitAny și strictNullChecks.

Unde poate fi utilizat Aspose.3D FOSS

  • Pipe‑line‑uri de active Node.js: Importă fișiere OBJ, validează și reorientează geometria și exportă ca GLB în CI.
  • Unelte pentru jocuri: Procesează în lot modele 3D fără un motor sau renderer nativ.
  • Fluxuri de lucru pentru imprimare 3D: Citește, validează și reexportă fișiere STL și 3MF.
  • Backend-uri fără server: Rulați puncte finale de conversie 3D în Lambda sau Cloud Functions.
  • Migrarea conținutului: Convertiți între familii de formate la scară largă dintr-un singur script.

Opțiuni per-format și control al coordonatelor

  • Orientarea sistemului de coordonate: Inversează axele și ajustează scara în funcție de format cu clasele de opțiuni.
  • Normalizarea normalelor: Normalizează automat normalele vârfurilor la încărcare sau salvare.
  • Ieșire binară vs. JSON: Selectează GLB compact sau glTF lizibil prin GltfSaveOptions.
  • Controlul încărcării materialelor: Activează sau dezactivează încărcarea MTL/texturi pentru parsare mai rapidă.
  • Fidelitatea round‑trip: Nodurile necunoscute ale graficului de scenă sunt păstrate exact la re-salvare.

Experiența dezvoltatorului

Aspose.3D FOSS pentru instalări TypeScript cu o singură comandă npm install @aspose/3d. Nu există add-on-uri native de compilat. Biblioteca este pur TypeScript/JavaScript cu o singură dependență instalată automat (xmldom).

API-ul puternic tipizat oferă completă autocompletare în IDE pentru fiecare clasă a graficului de scenă și opțiune de format. Biblioteca vizează Node.js 18–22+ și TypeScript 5.0+, rulează identic pe runner-ele CI Linux și stațiile de lucru ale dezvoltatorilor, și este licențiată sub MIT cu un tracker de probleme deschis pe GitHub.

Încarcă o scenă OBJ și exportă ca glTF

Instalați cu npm, apoi folosiți metoda sincronă scene.open() cu ObjLoadOptions pentru a încărca mesh-ul împreună cu fișierul său de material MTL. Apelarea scene.save() cu extensia .gltf scrie JSON standard glTF 2.0; formatul este dedus automat din extensia fișierului.

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ă ca JSON glTF 2.0
scene.save("model.gltf");

Convertește STL în GLB binar

Pentru a genera un GLB binar compact în locul glTF-ului JSON implicit, transmiteți GltfSaveOptions cu binaryMode = true.

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

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

// Salvează ca GLB binar compact
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Ce este Aspose.3D FOSS pentru TypeScript?

Este o bibliotecă gratuită, licențiată sub MIT, pentru TypeScript/Node.js, destinată încărcării, manipulării și salvării scenelor 3D fără a instala niciun addon nativ sau SDK extern.

Ce formate 3D sunt suportate?

OBJ (cu .mtl), glTF 2.0 și GLB, STL (binare și ASCII), COLLADA (DAE), 3MF și FBX. Fiecare format are o clasă de opțiuni tipizată dedicată.

Necesită addon-uri native Node.js?

Nu. Aspose.3D FOSS pentru TypeScript este JavaScript/TypeScript pur. Nu necesită niciun pas de compilare și are o singură dependență la runtime (xmldom) instalată automat de npm.

Cum îl instalez?

Rulați npm install @aspose/3d. Nu sunt necesare pachete de sistem suplimentare sau addonuri native.

Ce versiuni de Node.js și TypeScript sunt suportate?

Node.js 18, 20 și 22+. TypeScript 5.0+. Biblioteca se compilează în CommonJS și funcționează cu setări stricte de TypeScript.

Vine cu definiții de tip TypeScript?

Da. Toate clasele, metodele, enumerațiile și tipurile de opțiuni sunt complet tipizate cu noImplicitAny și strictNullChecks activate.

Pot controla orientarea sistemului de coordonate?

Da. Clasele de opțiuni per-format, cum ar fi ObjLoadOptions și GltfSaveOptions, îți permit să inversezi axele, să ajustezi scala și să normalizezi normalele fără cod de parsare personalizat.

Unde pot găsi codul sursă?

Biblioteca este licențiată sub MIT și găzduită pe GitHub. Raportările de erori și cererile de pull sunt binevenite.

  

Support and Learning Resources

 Română