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

Aspose.3D FOSS pro TypeScript

Načtěte, vytvořte, transformujte a exportujte 3D scény z Node.js — plně typované, open-source a připravené pro produkci s jedinou instalací npm.

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

Dokumentace GitHub

Open-Source TypeScript knihovna pro zpracování 3D souborů

Aspose.3D FOSS for TypeScript je knihovna licencovaná pod MIT, určená pro práci s 3D formáty souborů v aplikacích Node.js. Nainstalujte ji pomocí jediného příkazu npm install @aspose/3d a okamžitě začněte číst, vytvářet a zapisovat 3D scény v TypeScriptu, bez nutnosti kompilovat nativní doplňky, instalovat externí SDK ani vyžadovat renderer.

Knihovna poskytuje plně typované API scénografického grafu postavené kolem Scene, Node, Entity, Mesh, Camera, Light a Transform, stejný konceptuální model používaný profesionálními 3D nástroji. Podpora formátů zahrnuje OBJ (Wavefront, s načítáním materiálů .mtl), glTF 2.0 a binární GLB (PBR materiály), STL (binární a ASCII, plná zpětná konverze), COLLADA (DAE), 3MF a FBX. Třídy možností pro jednotlivé formáty, jako jsou ObjLoadOptions a GltfSaveOptions, vám poskytují přesnou kontrolu nad orientací souřadnicového systému, měřítkem, normalizací normál, binárním vs. JSON výstupem a načítáním materiálů.

Aspose.3D FOSS cílí na Node.js 18, 20 a 22+ s TypeScript 5.0+ a kompiluje do CommonJS. Knihovna je dodávána s přísnými nastaveními kompilátoru TypeScript (noImplicitAny, strictNullChecks), takže vaše IDE poskytuje úplné automatické doplňování a bezpečnost během kompilace. Její jediná runtime závislost, xmldom, se nainstaluje automaticky. Pro rodinu podnikových produktů viz Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Načíst soubory Wavefront OBJ s připojenými definicemi materiálů.
  • glTF 2.0 / GLB: Načítání PBR materiálů a binární výstup GLB pomocí GltfSaveOptions.
  • STL: Číst a zapisovat jak binární, tak ASCII STL s úplným ověřením roundtripu.
  • COLLADA, 3MF, FBX: Další podpora formátů s třídami možností pro jednotlivé formáty.
  • Plné typy TypeScript: Každá třída, metoda a volba jsou silně typizovány pomocí noImplicitAny a strictNullChecks.

Kde lze použít Aspose.3D FOSS

  • Node.js pipeline pro aktiva: Importovat soubory OBJ, validovat a přeorientovat geometrii a exportovat jako GLB v CI.
  • Nástroje pro hry: Dávkově zpracovávejte 3D sítě bez nativního enginu nebo rendereru.
  • 3D tiskové pracovní postupy: Číst, ověřovat a znovu exportovat soubory STL a 3MF.
  • Serverless backends: Spusťte 3D konverzní endpointy v Lambda nebo Cloud Functions.
  • Migrace obsahu: Převádějte mezi rodinami formátů ve velkém měřítku z jediného skriptu.

Možnosti pro každý formát a řízení souřadnic

  • Orientace souřadnicového systému: Překlopte osy a upravte měřítko podle formátu pomocí tříd možností.
  • Normal normalization: Automaticky normalizovat normály vrcholů při načítání nebo ukládání.
  • Binární vs. JSON výstup: Vyberte kompaktní GLB nebo čitelný glTF pomocí GltfSaveOptions.
  • Ovládání načítání materiálu: Povolit nebo zakázat načítání MTL/textur pro rychlejší parsování.
  • Věrnost při zpětném průchodu: Neznámé uzly scénového grafu jsou při opětovném uložení zachovány doslovně.

Zkušenost vývojáře

Aspose.3D FOSS pro TypeScript se nainstaluje jedním příkazem npm install @aspose/3d. Neexistují žádné nativní doplňky ke kompilaci. Knihovna je čistý TypeScript/JavaScript s jednou automaticky instalovanou závislostí (xmldom).

Silně typované API poskytuje kompletní automatické doplňování v IDE pro každou třídu grafu scény a možnost formátu. Knihovna cílí na Node.js 18–22+ a TypeScript 5.0+, běží identicky na Linuxových CI runnerů a vývojářských pracovních stanicích a je licencována pod MIT s otevřeným sledovačem problémů na GitHubu.

Načtěte OBJ scénu a exportujte jako glTF

Nainstalujte pomocí npm, pak použijte scene.open() s ObjLoadOptions k načtení sítě spolu s jejím souborem materiálu MTL. Oba open() i save() jsou synchronní — není potřeba await ani řetězení Promise. Volání scene.save() s .gltf příponou zapíše standardní glTF 2.0 JSON — formát je automaticky odvozen z přípony souboru.

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

Převést STL na binární GLB

Aby se vytvořil kompaktní binární GLB místo výchozího JSON glTF, předávejte GltfSaveOptions s binaryMode = true. Oba open() i save() jsou synchronní — není potřeba žádný 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);

Často kladené dotazy

Co je Aspose.3D FOSS pro TypeScript?

Jedná se o bezplatnou knihovnu TypeScript/Node.js s licencí MIT pro načítání, manipulaci a ukládání 3D scén bez instalace jakéhokoli nativního doplňku nebo externího SDK.

Které 3D formáty jsou podporovány?

OBJ (s .mtl), glTF 2.0 a GLB, STL (binární a ASCII), COLLADA (DAE), 3MF a FBX. Každý formát má vlastní typovanou třídu možností.

Vyžaduje nativní doplňky Node.js?

Ne. Aspose.3D FOSS pro TypeScript je čistý JavaScript/TypeScript. Nevyžaduje žádný krok kompilace a má jedinou runtime závislost (xmldom) nainstalovanou automaticky pomocí npm.

Jak to nainstaluji?

Spusťte npm install @aspose/3d. Nejsou vyžadovány žádné další systémové balíčky ani nativní doplňky.

Které verze Node.js a TypeScript jsou podporovány?

Node.js 18, 20 a 22+. TypeScript 5.0+. Knihovna se kompiluje do CommonJS a funguje se striktními nastaveními TypeScriptu.

Dodává se s definicemi typů TypeScript?

Ano. Všechny třídy, metody, výčty a typy možností jsou plně typizovány s povoleným noImplicitAny a strictNullChecks.

Mohu řídit orientaci souřadnicového systému?

Ano. Třídy možností pro jednotlivé formáty, jako jsou ObjLoadOptions a GltfSaveOptions, vám umožňují otáčet osy, upravovat měřítko a normalizovat normály bez vlastního parsovacího kódu.

Kde mohu najít zdrojový kód?

Knihovna je licencována pod MIT a je hostována na GitHubu. Hlášení chyb a pull requesty jsou vítány.

  

Podpora a vzdělávací materiály

 Čeština