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

Aspose.3D FOSS pre TypeScript

Načítajte, konštruujte, transformujte a exportujte 3D scény z Node.js — plne typované, open-source a pripravené do produkcie s jedinou inštaláciou npm.

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

Documentation GitHub

Open-Source TypeScript knižnica pre spracovanie 3D súborov

Aspose.3D FOSS pre TypeScript je knižnica licencovaná pod MIT pre prácu s 3D formátmi súborov v aplikáciách Node.js. Nainštalujte ju jedným príkazom npm install @aspose/3d a okamžite začnite čítať, konštruovať a zapisovať 3D scény v TypeScripte, bez nutnosti kompilovať natívne doplnky, bez inštalácie externých SDK a bez potreby renderera.

Knižnica poskytuje plne typované API scény‑grafu postavené okolo Scene, Node, Entity, Mesh, Camera, Light a Transform, rovnaký konceptuálny model, ktorý používajú profesionálne 3D nástroje. Podpora formátov zahŕňa OBJ (Wavefront, s načítaním materiálov .mtl), glTF 2.0 a binárny GLB (PBR materiály), STL (binárny a ASCII, plná spätná konverzia), COLLADA (DAE), 3MF a FBX. Triedy možností pre jednotlivé formáty, ako sú ObjLoadOptions a GltfSaveOptions, vám poskytujú presnú kontrolu nad orientáciou súradnicového systému, mierkou, normalizáciou normál, binárnym vs. JSON výstupom a načítaním materiálov.

Aspose.3D FOSS ciele Node.js 18, 20 a 22+ s TypeScript 5.0+ a kompiluje do CommonJS. Knižnica je dodávaná so striktnými nastaveniami kompilátora TypeScript (noImplicitAny, strictNullChecks), takže vaše IDE poskytuje úplné automatické dopĺňanie a bezpečnosť počas kompilácie. Jej jediná runtime závislosť, xmldom, sa inštaluje automaticky. Pre rodinu podnikových produktov pozri Aspose.3D — Enterprise Product Family.

Podpora 3D formátov a typované API pre scénový graf

  • OBJ / MTL: Načítajte súbory Wavefront OBJ s pripojenými definíciami materiálov.
  • glTF 2.0 / GLB: Načítanie PBR materiálu a binárny výstup GLB prostredníctvom GltfSaveOptions.
  • STL: Čítajte a zapisujte binárne aj ASCII STL s úplným overením roundtrip.
  • COLLADA, 3MF, FBX: Ďalšia podpora formátov s triedami možností pre každý formát.
  • Full TypeScript types: Každá trieda, metóda a možnosť je silne typovaná pomocou noImplicitAny a strictNullChecks.

Kde môže byť Aspose.3D FOSS použitý

  • Node.js asset pipelines: Importovať OBJ súbory, overiť a preorientovať geometriu a exportovať ako GLB v CI.
  • Game tooling: Hromadne spracovávať 3D siete bez natívneho enginu alebo renderera.
  • 3D printing workflows: Čítajte, overujte a znovu exportujte súbory STL a 3MF.
  • Serverless backendy: Spúšťajte koncové body konverzie 3D v Lambda alebo Cloud Functions.
  • Migrácia obsahu: Konvertovať medzi rodinami formátov vo veľkom rozsahu z jedného skriptu.

Možnosti pre každý formát a kontrola súradníc

  • Orientácia súradnicového systému: Preklopiť osi a upraviť mierku podľa formátu pomocou tried možností.
  • Normalizácia normálov: Automaticky normalizovať normály vrcholov pri načítaní alebo uložení.
  • Binárny vs. JSON výstup: Vyberte kompaktný GLB alebo čitateľný glTF prostredníctvom GltfSaveOptions.
  • Ovládanie načítavania materiálu: Povoľte alebo zakážte načítavanie MTL/textúr pre rýchlejšie parsovanie.
  • Presnosť pri oboch smeroch: Neznáme uzly grafu scény sú pri opätovnom uložení zachované doslovne.

Skúsenosti vývojára

Aspose.3D FOSS pre TypeScript sa inštaluje jedným príkazom npm install @aspose/3d. Neexistujú žiadne natívne doplnky na kompiláciu. Knižnica je čistý TypeScript/JavaScript s jednou automaticky nainštalovanou závislosťou (xmldom).

Silno typované API poskytuje úplné automatické dopĺňanie v IDE pre každú triedu grafu scény a možnosť formátu. Knižnica ciele Node.js 18–22+ a TypeScript 5.0+, beží identicky na Linux CI runneroch a vývojárskych pracovných staniciach a je licencovaná pod MIT s otvoreným sledovačom problémov na GitHub.

Načítajte OBJ scénu a exportujte ako glTF

Nainštalujte pomocou npm, potom použite scene.open() s ObjLoadOptions na načítanie siete spolu s jej MTL materiálovým súborom. Oba open() a save() sú synchronné — nie je potrebné await ani reťazenie Promise. Volaním scene.save() s .gltf príponou sa zapisuje štandardný glTF 2.0 JSON — formát sa automaticky odvodí z prípony súboru.

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

Previesť STL na binárny GLB

Aby ste vytvorili kompaktný binárny GLB namiesto predvoleného JSON glTF, použite GltfSaveOptions s binaryMode = true. Obe open() a save() sú synchronné — nie je potrebné 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

Čo je Aspose.3D FOSS pre TypeScript?

Je to bezplatná knižnica TypeScript/Node.js s licenciou MIT na načítanie, manipuláciu a ukladanie 3D scén bez inštalácie akéhokoľvek natívneho doplnku alebo externého SDK.

Aké 3D formáty sú podporované?

OBJ (s .mtl), glTF 2.0 a GLB, STL (binárny a ASCII), COLLADA (DAE), 3MF a FBX. Každý formát má vlastnú typovanú triedu s možnosťami.

Vyžaduje to natívne doplnky Node.js?

Nie. Aspose.3D FOSS pre TypeScript je čistý JavaScript/TypeScript. Nevyžaduje žiadny krok kompilácie a má jedinú runtime závislosť (xmldom) nainštalovanú automaticky cez npm.

Ako ho nainštalovať?

Spustite npm install @aspose/3d. Nie sú potrebné žiadne ďalšie systémové balíky ani natívne doplnky.

Aké verzie Node.js a TypeScript sú podporované?

Node.js 18, 20 a 22+. TypeScript 5.0+. Knižnica sa kompiluje do CommonJS a funguje s prísnymi nastaveniami TypeScriptu.

Dodáva sa s definíciami typov TypeScript?

Áno. Všetky triedy, metódy, enumy a typy možností sú plne typované s povoleným noImplicitAny a strictNullChecks.

Môžem ovládať orientáciu súradnicového systému?

Áno. Triedy možností pre jednotlivé formáty, ako napríklad ObjLoadOptions a GltfSaveOptions, vám umožňujú preklopiť osi, upraviť mierku a normalizovať normály bez vlastného parsovacieho kódu.

Kde môžem nájsť zdrojový kód?

Knižnica je licencovaná pod MIT a je hostovaná na GitHub. Správy o chybách a pull requesty sú vítané.

  

Support and Learning Resources

 Slovenčina