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 — 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 zapisivati 3D scene u TypeScriptu, bez potrebe za izgradnjom native dodataka, bez instalacije vanjskih SDK-ova i bez zahtjeva za rendererom.

Biblioteka izlaže potpuno tipizirano API‑je za graf scena izgrađeno oko Scene, Node, Entity, Mesh, Camera, Light i Transform, istog konceptualnog modela koji koriste profesionalni 3D alati. Podrška formata uključuje OBJ (Wavefront, s 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, poput ObjLoadOptions i GltfSaveOptions, pružaju preciznu kontrolu nad orijentacijom koordinatnog sustava, skalom, normalizacijom normala, binarnim vs. JSON izlazom i učitavanjem materijala.

Aspose.3D FOSS cilja na Node.js 18, 20 i 22+ s TypeScriptom 5.0+ i kompilira se u CommonJS. Biblioteka dolazi s rigoroznim postavkama TypeScript kompajlera (noImplicitAny, strictNullChecks) kako bi vaš IDE pružao potpunu automatsku dopunu i sigurnost u vrijeme kompilacije. Njegova jedina runtime ovisnost, xmldom, instalira se automatski.

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

  • OBJ / MTL: Učitajte Wavefront OBJ datoteke s 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 s potpunom provjerom roundtripa.
  • COLLADA, 3MF, FBX: Dodatna podrška formata s klasama opcija po formatu.
  • Potpuni TypeScript tipovi: Svaka klasa, metoda i opcija snažno su tipizirane s noImplicitAny i strictNullChecks.

Gdje se Aspose.3D FOSS može koristiti

  • Node.js asset pipelines: Uvezite OBJ datoteke, provjerite i ponovno orijentirajte geometriju te izvezite kao GLB u CI.
  • Alati za igre: Grupno obrađujte 3D mreže bez izvornog enginea ili renderera.
  • Radni tokovi 3D ispisa: Čitajte, provjerite i ponovno izvezite STL i 3MF datoteke.
  • Serverless backends: Pokrenite 3D konverzijske krajnje točke u Lambda ili Cloud Functions.
  • Content migration: Pretvorite između obitelji formata u velikom opsegu iz jedne skripte.

Opcije po formatu i kontrola koordinata

  • Orijentacija koordinatnog sustava: Okrenite osi i prilagodite skalu po formatu s option classes.
  • Normalizacija normala: Automatski normalizirajte normalne vektore vrhova pri učitavanju ili spremanju.
  • Binarni vs. JSON izlaz: Odaberite kompaktan GLB ili čitljiv glTF putem GltfSaveOptions.
  • Kontrola učitavanja materijala: Omogućite ili onemogućite učitavanje MTL/tekstura za brže parsiranje.
  • Vjernost pri povratnom prolazu: Nepoznati čvorovi grafova scene očuvani su doslovno pri ponovnom spremanju.

Iskustvo programera

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

Jako tipizirano API pruža potpunu automatsku dopunu u IDE-u za svaku klasu grafova scene 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, te je licencirana pod MIT licencom s otvorenim sustavom praćenja problema na GitHubu.

Učitaj OBJ scenu i izvezi kao glTF

Instalirajte putem npm-a, zatim koristite sinkronu metodu scene.open() s ObjLoadOptions za učitavanje mreže zajedno s njenom MTL datotekom materijala. Pozivanjem scene.save() s 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");

Pretvori STL u binarni GLB

Da biste proizveli kompaktan binarni GLB umjesto zadane JSON glTF, proslijedite GltfSaveOptions s binaryMode = true.

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

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

// Spremi kao kompaktan binarni GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Što je Aspose.3D FOSS za TypeScript?

To je besplatna, MIT-licencirana TypeScript/Node.js biblioteka za učitavanje, manipulaciju i spremanje 3D scena bez instalacije bilo kojeg 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?

Ne. 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 native 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 hostirana na GitHubu. Prijave grešaka i pull requestovi su dobrodošli.

  

Resursi za podršku i učenje

 Hrvatski