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

Aspose.3D FOSS za TypeScript

Učitajte, konstruirajte, transformirajte i izvezite 3D scene iz Node.js‑a — potpuno tipizirano, open‑source i spremno za proizvodnju uz jednu npm instalaciju.

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

Naučiti GitHub

Open‑source TypeScript biblioteka za obradu 3D datoteka

Aspose.3D FOSS za TypeScript je MIT-licencirana biblioteka za rad s 3D formatima datoteka u Node.js aplikacijama. Instalirajte je jednim npm install @aspose/3d naredbom i odmah počnite čitati, konstruirati i pisati 3D scene u TypeScriptu, bez potrebe za izradom native dodataka, bez instalacije vanjskih SDK‑ova i bez renderera.

Biblioteka izlaže potpuno tipizirano API za graf scena izgrađeno 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, s učitavanjem materijala .mtl), glTF 2.0 i GLB binarni (PBR materijali), STL (binarni i ASCII, potpuni roundtrip), COLLADA (DAE), 3MF i FBX. Klase opcija po formatu poput ObjLoadOptions i GltfSaveOptions daju vam preciznu kontrolu nad orijentacijom koordinatnog sustava, skalom, normalizacijom normala, binarnim vs. JSON izlazom i učitavanjem materijala.

Aspose.3D FOSS cilja Node.js 18, 20 i 22+ s TypeScript 5.0+ i kompilira se u CommonJS. Biblioteka isporučuje stroga TypeScript postavke kompajlera (noImplicitAny, strictNullChecks) tako da vaš IDE pruža potpunu automatsku dopunu i sigurnost u vrijeme kompilacije. Njegova jedina runtime ovisnost, xmldom, instalira se automatski. Za enterprise obitelj proizvoda, pogledajte Aspose.3D — Enterprise Product Family.

Podrška za 3D formate i tipizirano API‑je za graf scena

  • OBJ / MTL: Učitaj Wavefront OBJ datoteke s pratećim definicijama materijala.
  • glTF 2.0 / GLB: Učitavanje PBR materijala i binarni GLB izlaz putem GltfSaveOptions.
  • STL: Čitaj i piši i binarni i ASCII STL s potpunom provjerom okruglog puta.
  • COLLADA, 3MF, FBX: Dodatna podrška formatima uz klase opcija po formatu.
  • Full TypeScript types: Svaka klasa, metoda i opcija strogo su tipizirane s noImplicitAny i strictNullChecks.

Gdje se Aspose.3D FOSS može koristiti

  • Node.js asset pipelines: Uvoz OBJ datoteka, provjera i ponovna orijentacija geometrije, te izvoz kao GLB u CI.
  • Alati za igre: Obrada 3D mreža u seriji bez izvornog motora ili renderera.
  • Radni tokovi 3D ispisa: Čitaj, provjeri i ponovo izvezi STL i 3MF datoteke.
  • Serverless backends: Pokrenite 3D konverzijske krajnje točke u Lambda ili Cloud Functions.
  • Migracija sadržaja: Pretvorite između obitelji formata u velikom opsegu iz jedne skripte.

Opcije po formatu i kontrola koordinata

  • Orijentacija koordinatnog sustava: Preokrenite osi i prilagodite skalu po formatu pomoću klasa opcija.
  • Normalizacija normala: Automatski normalizirajte normale vrhova pri učitavanju ili spremanju.
  • Binarni vs. JSON izlaz: Odaberite kompaktan GLB ili čitljiv glTF putem GltfSaveOptions.
  • Upravljanje učitavanjem materijala: Omogućite ili onemogućite učitavanje MTL/tekstura za brže parsiranje.
  • Round-trip fidelity: Nepoznati čvorovi scene-grapha čuvaju se doslovno pri ponovnom spremanju.

Iskustvo programera

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

Strogo tipizirano API pruža potpunu automatsku dopunu u IDE za svaku klasu grafova scena i opciju formata. Biblioteka cilja Node.js 18–22+ i TypeScript 5.0+, radi identično na Linux CI runnerima i radnim stanicama programera, i MIT-licensed s otvorenim issue trackerom na GitHubu.

Učitaj OBJ scenu i izvezi kao glTF

Instalirajte pomoću npm, a zatim upotrijebite scene.open() s ObjLoadOptions za učitavanje mreže zajedno s njenom MTL datotekom materijala. Oba open() i save() su sinkronizirana — nije potrebno await ili lančanje Promisea. Pozivanjem scene.save() s .gltf ekstenzijom 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Pretvori STL u binarni GLB

Za proizvodnju kompaktne binarne GLB umjesto zadane JSON glTF, proslijedite GltfSaveOptions s binaryMode = true. Oba open() i save() su sinkronizirana — 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);

Često postavljana pitanja

Što je Aspose.3D FOSS za TypeScript?

To je besplatna, MIT-licencirana TypeScript/Node.js biblioteka za učitavanje, manipuliranje i spremanje 3D scena bez instaliranja ikakvog native dodatka ili vanjskog SDK-a.

Koji 3D formati su podržani?

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

Zahtijeva li nativne Node.js dodatke?

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

Kako ga instalirati?

Pokrenite npm install @aspose/3d. Nisu potrebni dodatni sistemski paketi ili nativni dodaci.

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

Node.js 18, 20 i 22+. TypeScript 5.0+. Biblioteka se kompilira u CommonJS i radi s striktim TypeScript postavkama.

Dolazi li s TypeScript definicijama tipova?

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

Mogu li kontrolirati orijentaciju koordinatnog sustava?

Da. Klase opcija po formatu, poput ObjLoadOptions i GltfSaveOptions, omogućuju vam okretanje osi, podešavanje skale i normalizaciju normala bez prilagođenog koda za parsiranje.

Gdje mogu pronaći izvorni kod?

Biblioteka je licencirana pod MIT licencom i smještena na GitHubu. Prijave grešaka i pull requestovi su dobrodošli.

  

Resursi za podršku i učenje

 Hrvatski