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

Aspose.3D FOSS for TypeScript

Učitajte, konstruisite, transformišite i izvezite 3D scene iz Node.js — potpuno tipizovano, open-source i spremno za produkciju uz jednu 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 biblioteka pod MIT licencom za rad sa 3D formatima fajlova u Node.js aplikacijama. Instalirajte je jednim npm install @aspose/3d komandama i odmah počnite da čitate, konstrušite i pišete 3D scene u TypeScript-u, bez potrebe za kompajliranjem native dodataka, bez instaliranja eksternih SDK‑ova i bez renderera.

Biblioteka izlaže potpuno tipizovan API grafika scene zasnovan na Scene, Node, Entity, Mesh, Camera, Light i Transform, istom konceptualnom modelu 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, potpuna povratna obrada), COLLADA (DAE), 3MF i FBX. Klase opcija po formatu, kao što su ObjLoadOptions i GltfSaveOptions, pružaju preciznu kontrolu nad orijentacijom koordinatnog sistema, skalom, normalizacijom normala, binarnim naspram JSON izlazom i učitavanjem materijala.

Aspose.3D FOSS cilja Node.js 18, 20 i 22+ uz TypeScript 5.0+ i kompajlira se u CommonJS. Biblioteka dolazi sa strogim TypeScript kompajler postavkama (noImplicitAny, strictNullChecks) tako da vaš IDE pruža potpunu automatsku dopunu i sigurnost u vreme kompajliranja. Njena jedina runtime zavisnost, xmldom, se instalira automatski.

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

  • OBJ / MTL: Učitajte 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 toka.
  • COLLADA, 3MF, FBX: Dodatna podrška za formate uz klase opcija po formatu.
  • Full TypeScript types: Svaka klasa, metoda i opcija su strogo tipizovane uz noImplicitAny i strictNullChecks.

Gde se Aspose.3D FOSS može koristiti

  • Node.js asset pipeline‑i: Uvezite OBJ fajlove, validirajte i ponovo orijentišite geometriju, i izvezite kao GLB u CI.
  • Alati za igre: Grupno obrađujte 3D mreže bez native engine‑a ili renderera.
  • Radni tokovi za 3D štampu: Čitajte, validirajte i ponovo izvezite STL i 3MF fajlove.
  • Serverless backends: Pokrenite 3D konverzione krajnje tačke u Lambda ili Cloud Functions.
  • Content migration: Konvertujte između porodica formata u velikom obimu iz jednog skripta.

Opcije po formatu i kontrola koordinata

  • Orijentacija koordinatnog sistema: Preokrenite ose i prilagodite skalu po formatu pomoću klasa opcija.
  • Normalizacija normala: Automatski normalizujte normalne vektore vrhova 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/tekstura radi bržeg parsiranja.
  • Vernost pri povratnom prolazu: Nepoznati čvorovi scene‑grafova se čuvaju doslovno prilikom ponovnog čuvanja.

Iskustvo programera

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

Strogo tipizirani API pruža potpunu IDE automatsku dopunu za svaku klasu scene‑grafa i opciju formata. Biblioteka cilja Node.js 18–22+ i TypeScript 5.0+, radi identično na Linux CI runner‑ima i radnim stanicama developera, 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 sinhronu metodu scene.open() sa ObjLoadOptions da učitate mrežu zajedno sa njenom MTL datotekom materijala. Pozivanjem scene.save() sa ekstenzijom .gltf zapisuje 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());

// Izvezi kao glTF 2.0 JSON
scene.save("model.gltf");

Konvertuj STL u binarni GLB

Da biste proizveli kompaktan binarni GLB umesto podrazumevanog JSON glTF, prosledite GltfSaveOptions sa binaryMode = true.

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

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

// Sačuvaj kao kompaktan binarni 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 instalacije bilo kog native dodatka 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 posvećenu tipiziranu klasu opcija.

Da li zahteva native Node.js dodatke?

Ne. 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 dodaci.

Koje verzije Node.js-a i TypeScript-a 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 isporučuje TypeScript definicije 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 nađ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

 Српски