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

Aspose.3D FOSS za TypeScript

Učitajte, konstrušite, transformišite i izvezite 3D scene iz Node.js — potpuno tipizovano, open‑source i spremno za produkciju uz jedinstvenu npm instalaciju.

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

Documentation GitHub

Open‑source TypeScript biblioteka za obradu 3D fajlova

Aspose.3D FOSS za TypeScript je MIT-licencirana biblioteka za rad sa 3D formatima fajlova u Node.js aplikacijama. Instalirajte je jednim npm install @aspose/3d komandom i odmah počnite da čitate, konstrušite i pišete 3D scene u TypeScript-u, bez native dodataka za kompilaciju, bez eksternih SDK-ova za instalaciju i bez potrebnog renderera.

Biblioteka izlaže potpuno tipizovani API za graf scena izgrađen oko Scene, Node, Entity, Mesh, Camera, Light i Transform, isti konceptualni model koji koriste profesionalni 3D alati. Podrška za formate uključuje OBJ (Wavefront, sa učitavanjem .mtl materijala), glTF 2.0 i GLB binarni (PBR materijali), STL (binarni i ASCII, potpuni roundtrip), COLLADA (DAE), 3MF i FBX. Klase opcija po formatu, kao što su ObjLoadOptions i GltfSaveOptions, daju vam preciznu kontrolu nad orijentacijom koordinatnog sistema, skalom, normalizacijom normala, binarnim vs. JSON izlazom i učitavanjem materijala.

Aspose.3D FOSS cilja Node.js 18, 20 i 22+ sa TypeScript 5.0+ i kompajlira se u CommonJS. Biblioteka dolazi sa strogim TypeScript podešavanjima kompajlera (noImplicitAny, strictNullChecks) kako bi vaš IDE pružao potpunu automatsku dopunu i sigurnost u vreme kompajliranja. Njena jedina runtime zavisnost, xmldom, se instalira automatski. Za enterprise porodicu proizvoda, pogledajte Aspose.3D — Enterprise Product Family.

Podrška za 3D formate i tipizovani Scene‑Graph API

  • OBJ / MTL: Učitaj Wavefront OBJ fajlove sa pratećim definicijama materijala.
  • glTF 2.0 / GLB: Učitavanje PBR materijala i binarni GLB izlaz putem GltfSaveOptions.
  • STL: Čitajte i pišite i binarni i ASCII STL uz potpunu verifikaciju povratnog puta.
  • COLLADA, 3MF, FBX: Dodatna podrška za formate uz klase opcija po formatu.
  • Potpuni TypeScript tipovi: Svaka klasa, metoda i opcija su strogo tipizirane uz noImplicitAny i strictNullChecks.

Gde se Aspose.3D FOSS može koristiti

  • Node.js asset pipelines: Uvoz OBJ fajlova, validacija i re‑orientacija geometrije, i izvoz kao GLB u CI.
  • Alati za igre: Serijski obrađujte 3D mreže bez nativnog motora ili renderera.
  • Radni tokovi 3D štampe: Čitajte, validirajte i ponovo izvezite STL i 3MF fajlove.
  • Serverless pozadine: Pokrenite 3D konverzione krajnje tačke u Lambda ili Cloud Functions.
  • Migracija sadržaja: Konvertujte između porodica formata u velikom obimu iz jednog skripta.

Opcije po formatu i kontrola koordinata

  • Orijentacija koordinatnog sistema: Okrenite ose i prilagodite skalu po formatu uz klase opcija.
  • Normalna normalizacija: Automatski normalizujte normalne vektore vrha prilikom učitavanja ili čuvanja.
  • Binarni vs. JSON izlaz: Izaberite kompaktan GLB ili čitljiv glTF putem GltfSaveOptions.
  • Kontrola učitavanja materijala: Omogućite ili onemogućite učitavanje MTL/teksture za brže parsiranje.
  • Round-trip fidelity: Nepoznati čvorovi scene-graph-a se čuvaju doslovno prilikom ponovnog čuvanja.

Iskustvo programera

Aspose.3D FOSS za TypeScript se instalira jednim npm install @aspose/3d komandom. Nema nativnih dodataka za kompilaciju. Biblioteka je čisti TypeScript/JavaScript sa jednom automatski instaliranom zavisnošću (xmldom).

Strogo tipizirani API pruža potpunu automatsku dopunu u IDE za svaku klasu scene‑graph i opciju formata. Biblioteka cilja Node.js 18–22+ i TypeScript 5.0+, radi identično na Linux CI runner‑ima i radnim stanicama programera, i objavljena je pod MIT licencom sa otvorenim sistemom za praćenje problema na GitHub‑u.

Učitaj OBJ scenu i izvezi kao glTF

Instalirajte pomoću npm, zatim koristite scene.open() sa ObjLoadOptions da učitate mrežu zajedno sa njenom MTL materijalnom datotekom. Obe open() i save() su sinhrone — nije potrebno await ili lančanje Promise‑ova. Pozivanjem scene.save() sa .gltf ekstenzijom piše se standardni glTF 2.0 JSON — format se automatski zaključuje iz ekstenzije datoteke.

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

Pretvori STL u Binary GLB

Da biste proizveli kompaktan binarni GLB umesto podrazumevanog JSON glTF, prosledite GltfSaveOptions sa binaryMode = true. I open() i save() su sinhroni — nije potreban 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

Šta je Aspose.3D FOSS za TypeScript?

To je besplatna, MIT-licencirana TypeScript/Node.js biblioteka za učitavanje, manipulaciju i čuvanje 3D scena bez instaliranja bilo kog native addon ili eksternog SDK-a.

Koji 3D formati su podržani?

OBJ (sa .mtl), glTF 2.0 i GLB, STL (binarni i ASCII), COLLADA (DAE), 3MF i FBX. Svaki format ima posebnu tipiziranu klasu opcija.

Da li zahteva native Node.js dodatke?

No. Aspose.3D FOSS za TypeScript je čisti JavaScript/TypeScript. Ne zahteva korak kompilacije i ima jedinu runtime zavisnost (xmldom) koja se automatski instalira putem npm-a.

Kako da ga instaliram?

Pokrenite npm install @aspose/3d. Nisu potrebni dodatni sistemski paketi ili native dodatci.

Koje Node.js i TypeScript verzije su podržane?

Node.js 18, 20 i 22+. TypeScript 5.0+. Biblioteka se kompajlira u CommonJS i radi sa striktim TypeScript podešavanjima.

Da li dolazi sa TypeScript definicijama tipova?

Da. Sve klase, metode, enumeracije i tipovi opcija su potpuno tipizovani uz omogućene noImplicitAny i strictNullChecks.

Mogu li da kontrolišem orijentaciju koordinatnog sistema?

Da. Klase opcija po formatu, kao što su ObjLoadOptions i GltfSaveOptions, omogućavaju vam da okrenete ose, podesite skalu i normalizujete normale bez prilagođenog koda za parsiranje.

Gde mogu da pronađem izvorni kod?

Biblioteka je licencirana pod MIT licencom i hostovana na GitHub-u. Izveštaji o greškama i pull zahtevi su dobrodošli.

  

Support and Learning Resources

 Српски