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

Aspose.3D FOSS for TypeScript

Încarcă, construiește, transformă și exportă scene 3D din Node.js — complet tipat, open‑source și pregătit pentru producție cu un singur npm install.

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

Documentation GitHub

Biblioteca Open-Source TypeScript pentru prelucrarea 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, 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. Pentru familia de produse enterprise, vedeți Aspose.3D — Enterprise Product Family.

Suport pentru format 3D și API-ul Scene-Graph Tipat

  • ** OBJ / MTL:** Încărcați fișierele Wavefront OB J cu definițiile de materiale însoțitoare.
  • glTF 2.0 / GLB: Încărcarea materialului PBR și ieșirea binară a GDB prin GltfSaveOptions.
  • STL: Citirea și scrierea atât a STL binar cât și ASCII cu verificare completă de întoarcere.
  • COLLADA, 3MF, FBX: Suport suplimentar pentru format cu clase de opțiuni per format.
  • ** Tipuri complete de tipografie:** Fiecare clasă, metodă și opțiune este puternic tipată cu noImplicitAny și strictNullChecks.

Unde Aspose.3D FOSS poate fi utilizat

  • ** Pipelines de active Node.js:** Importarea fișierelor OBJ, validarea și reorientarea geometriei și exportul ca GLB în CI.
  • Oferte de joc: Mese 3D procesate în loturi fără un motor sau render nativ.
  • ** Fluxuri de lucru pentru imprimare 3D:** Citirea, validarea și reexportul fișierelor STL și 3MF.
  • ** Backend-uri fără server:** rulați punctele de conversiune 3D în Lambda sau Cloud Functions.
  • Migrația conținutului: Convertiti între familiile de format la scară largă dintr-un singur script.

Opțiuni de format și control al coordonatării

  • Orientarea sistemului de coordonate: Așele Flip și ajustarea scării per format cu clase opționale.
  • Normalizare normală: Normalizați automat valorile normale ale vericului la încărcare sau salvare.
  • Export binar vs. JSON: Selectați GLB compact sau glTF ușor de citit prin GltfSaveOptions.
  • Controlul încărcării materialului: Activizați sau dezactivați încărsarea MTL/textură pentru o analiză mai rapidă.
  • Fidelitatea de întoarcere: Nodurile grafice necunoscute sunt păstrate la redescris.

Experiență de dezvoltator

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

API tipizat puternic oferă completă completare automată î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 runner-ele CI Linux și stațiile de lucru ale dezvoltatorilor, și este licențiată sub MIT cu un tracker de issue deschis pe GitHub.

Încărcați o scenă OBJ și Exportați 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");

Convertiti STL în GLB binar

Pentru a produce un GLB binar compact în locul glTF JSON implicit, trece 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ă, cu licență 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 (binar și ASCII), COLLADA (DAE), 3MF și FBX. Fiecare format are o clasă de opțiuni tipate dedicată.

Are nevoie de add-on Node.js nativ?

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

Cum îl instalez?

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

Ce versiuni Node.js și TypeScript sunt suportate?

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

E livrat cu definiții de tip TypeScript?

Da. Toate clasele, metodele, numerele și tipurile de opțiuni sunt complet tipate 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ă schimbați axele, să ajustați scara și să normalizați normale fără cod personalizat de parcare.

Unde pot găsi codul sursă?

Biblioteca este licențiată de MIT și găzduită pe GitHub. Raporturile cu buguri și solicitările sunt binevenite.

  

Support and Learning Resources

 Română