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

Aspose.3D FOSS for TypeScript

Načítajte, konštruujte, transformujte a exportujte 3D scény z Node.js — plne typované, open‑source a pripravené na produkciu 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 npm install @aspose/3d príkazom a okamžite začnite čítať, konštruovať a zapisovať 3D scény v TypeScript, bez nutnosti kompilovať natívne doplnky, inštalovať externé SDK a bez požiadavky na renderér.

Knižnica poskytuje plne typovaný graf scén API 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 napríklad 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 sa do CommonJS. Knižnica je dodávaná s prísnymi nastaveniami TypeScript kompilátora (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 nainštaluje automaticky. Pre podnikové produktové rodiny pozri Aspose.3D — Enterprise Product Family.

Podpora 3D formátu a API typovaného scénového grafu

  • ** OBJ / MTL:** Nahrávajte súbory Wavefront OB J s sprievodnými definíciami materiálov.
  • glTF 2.0 / GLB: Nahradenie materiálu PBR a binárny výstup z GDB prostredníctvom GltfSaveOptions.
  • STL: Čítať a písať binárne aj ASCII STL s úplným overením cesty späť.
  • COLLADA, 3MF, FBX: Dodatočná podpora formátov s triedami možností na jednotlivé formáty.
  • Plné typy typopisu: Každá trieda, metóda a možnosť sú silne vytypované noImplicitAny a strictNullChecks.

Kde sa Aspose.3D FOSS môže použiť

  • Pipelines aktív Node.js: Importovať súbory OBJ, overovať a preorientovať geometriu a exportovať ako GLB v CI.
  • Hra: 3D sieťky s batch-procesom bez vlastného motora alebo renderera.
  • Prípady 3D tlače: Čítať, overovať a reexportovať súbory STL a 3MF.
  • Serverless backends: Spravte koncové 3D konverzie v Lambda alebo Cloud Functions.
  • Migrácia obsahu: Konverzia medzi rodinami formátov v meradle z jedného skriptu.

Možnosti formátu a kontrola koordinátov

  • Orientácia koordinátového systému: Presunúť osy a upraviť stupňovanie podľa formátu s možnosťami triedy.
  • Normalná normalizácia: Automaticky normalizacia normálnych vrcholov pri zaťažení alebo uložení.
  • Dvojstranný vs. výstup JSON: Vyberte kompaktný GLB alebo čitateľný glTF prostredníctvom GltfSaveOptions.
  • Kontrolovanie načítania materiálu: Povolenie alebo vypnutie načítavania MTL/textúry pre rýchlejšie analýzy.
  • Vrátane: Neznáme scény-grafy sa zachovávajú doslovne pri opätovnom ukladaní.

Skúsenosti vývojára

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

Silne typovaná API poskytuje plné automatické dokončenie IDE pre každú triedu a možnosť formátu scény. Knižnica je zameraná na Node.js 1822+ a TypeScript 5.0+, funguje identicky v Linuxových bežcoch CI a vývojárskych pracovných staniciach, a má licenciu MIT s otvoreným sledovačom problémov na GitHub.

Nahradenie scény OBJ a export 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 zapíše š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");

Konverzia STL na binárny GLB

Na vytvorenie kompaktného binárneho GLB namiesto predvoleného JSON glTF, prejdite GltfSaveOptions s binaryMode = true. Oba open() a save() sú synchrónne 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 nativu addonu alebo externého SDK.

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

Obj (s .mtl), glTF 2.0 a GLB, STL (binárne a ASCII), COLLADA (DAE), 3MF a FBX. Každý formát má špeciálnu triedu typovaných možností.

Vyžaduje to nativné doplnky Node.js?

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

Ako ho nainštalujem?

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

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

Node.js 18, 20 a 22+. TypeScript 5.0+. Knižnica kompiluje na CommonJS a pracuje so prísnymi nastavením Typiskripta.

Má to príslušenstvo s definíciami typov TypeScript?

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

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

Áno. Vybrané triedy podľa formátu, ako ObjLoadOptions a GltfSaveOptions vám umožňujú prevrátiť osy, upraviť stupňovanie a normalizovať normály bez vlastného kódu analýzy.

Kde nájdem zdrojový kód?

Knižnica je licencovaná MIT a hosťovaná na GitHub.

  

Support and Learning Resources

 Slovenčina