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 tipizată, open-source și pregătită 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ă necesitatea unui renderer.

Biblioteca expune un API de graf de scenă complet tipizat, construit în jurul 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, roundtrip complet), COLLADA (DAE), 3MF și FBX. Clasele de opțiuni per-format, cum ar fi ObjLoadOptions și GltfSaveOptions, îți oferă control precis asupra orientării sistemului de coordonate, scalării, normalizării normelor, ieșire binară 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 tău să ofere completare automată și siguranță la compilare. Dependența sa unică la runtime, xmldom, este instalată automat. Pentru familia de produse enterprise, vezi Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Încarcă fișiere Wavefront OBJ cu definiții de material însoțitoare.
  • glTF 2.0 / GLB: Încărcarea materialelor PBR și ieșirea binară GLB prin GltfSaveOptions.
  • STL: Citește și scrie atât STL binar, cât și ASCII, cu verificare completă a roundtrip‑ului.
  • COLLADA, 3MF, FBX: Suport suplimentar pentru format cu clase de opțiuni per-format.
  • Tipuri TypeScript complete: Fiecare clasă, metodă și opțiune este tipizată strict cu noImplicitAny și strictNullChecks.

Unde Aspose.3D FOSS poate fi utilizat

  • Node.js asset pipelines: Importați fișiere OBJ, validați și reorientați geometria și exportați ca GLB în CI.
  • Instrumente pentru jocuri: Procesează în lot rețele 3D fără un motor sau renderer nativ.
  • Fluxuri de lucru pentru imprimarea 3D: Citește, validează și reexportă fișiere STL și 3MF.
  • Serverless backends: 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: Inversați axele și ajustați scara pentru fiecare format cu clasele de opțiuni.
  • Normal normalization: Normalizează automat normele vârfurilor la încărcare sau salvare.
  • Binare vs. JSON ieșire: Selectați GLB compact sau glTF lizibil prin GltfSaveOptions.
  • Controlul încărcării materialului: Activați sau dezactivați încărcarea MTL/texture pentru o analiză 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 TypeScript se instalează cu o singură comandă npm install @aspose/3d. Nu există addon-uri native de compilat. Biblioteca este pur TypeScript/JavaScript cu o dependență auto‑instalată (xmldom).

API-ul puternic tipizat oferă completare automată completă în IDE pentru fiecare clasă de graf de scenă și opțiune de format. Biblioteca vizează Node.js 18–22+ și TypeScript 5.0+, rulează identic pe rulere CI Linux și stații de lucru ale dezvoltatorilor, și este MIT-licensed cu un tracker de probleme deschis pe GitHub.

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

Instalați cu npm, apoi folosiți scene.open() cu ObjLoadOptions pentru a încărca mesh-ul împreună cu fișierul său de material MTL. Atât open(), cât și save() sunt sincrone — nu este necesar await sau lanțuri de Promise. Apelarea lui scene.save() cu o extensie .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 as glTF 2.0 JSON
scene.save("model.gltf");

Convertește STL în GLB binar

Pentru a produce un GLB binar compact în locul glTF-ului implicit JSON, transmite GltfSaveOptions cu binaryMode = true. Atât open(), cât și save() sunt sincrone — nu este necesar 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);

Frequently Asked Questions

Ce este Aspose.3D FOSS pentru TypeScript?

Este o bibliotecă gratuită, licențiată MIT, TypeScript/Node.js pentru încărcarea, manipularea și salvarea 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 addon-uri 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.

Este livrat 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, vă permit să răsturnați axele, să ajustați scala și să normalizați 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ă