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 for TypeScript je MIT-licencovaná knižnica 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, inštalovať externé SDK a bez potreby renderera.

Knižnica poskytuje plne typované API grafu scény postavené okolo Scene, Node, Entity, Mesh, Camera, Light a Transform, rovnaký konceptuálny model, aký používajú profesionálne 3D nástroje. Podporované formáty zahŕňajú 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á kompatibilita), COLLADA (DAE), 3MF a FBX. Triedy možností pre jednotlivé formáty, ako 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á 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.

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

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

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

  • Node.js pipeline pre aktíva: Importujte OBJ súbory, overte a preorientujte geometriu a exportujte ako GLB v CI.
  • Nástroje pre hry: Hromadne spracujte 3D siete bez natívneho enginu alebo renderera.
  • Pracovné postupy pre 3D tlač: Čítajte, overujte a opätovne exportujte STL a 3MF súbory.
  • Serverless backends: Spúšťajte koncové body pre 3D konverziu v Lambda alebo Cloud Functions.
  • Content migration: Konvertujte 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: Preklápajte osi a upravujte mierku podľa formátu pomocou tried volieb.
  • Normalizácia normál: Automaticky normalizovať normály vrcholov pri načítaní alebo uložení.
  • Binárny vs. JSON výstup: Vyberte kompaktný GLB alebo čitateľný glTF pomocou GltfSaveOptions.
  • Ovládanie načítania materiálov: Povoliť alebo zakázať načítanie MTL/textúr pre rýchlejšie parsovanie.
  • Presnosť pri spätnom spracovaní: Neznáme uzly scény grafu sa pri opätovnom uložení zachovajú doslovne.

Skúsenosti vývojára

Aspose.3D FOSS pre TypeScript inštalácie s jediným príkazom npm install @aspose/3d. Nie sú ž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 scény‑grafu a možnosť formátu. Knižnica cílí na Node.js 18–22+ a TypeScript 5.0+, beží identicky na Linux CI runneroch aj 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 synchronnú metódu scene.open() s ObjLoadOptions na načítanie siete spolu s jej MTL súborom materiálu. Volaním scene.save() s príponou .gltf 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());

// Exportovať ako glTF 2.0 JSON
scene.save("model.gltf");

Previesť STL na binárny GLB

Ak chcete vytvoriť kompaktný binárny GLB namiesto predvoleného JSON glTF, odovzdajte GltfSaveOptions s binaryMode = true.

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

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

// Uložiť ako kompaktný binárny 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á, pod licenciou MIT, knižnica TypeScript/Node.js na načítanie, manipuláciu a ukladanie 3D scén bez potreby inštalovať akýkoľvek natívny doplnok alebo externý 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ú typovú triedu možností.

Vyžaduje natívne doplnky Node.js?

Nie. Aspose.3D FOSS pre TypeScript je čistý JavaScript/TypeScript. Nevyžaduje žiadny kompilovací krok a má jedinú runtime závislosť (xmldom), ktorá sa nainštaluje 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.

Ktoré 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, výčty 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