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

Aspose.3D FOSS for TypeScript

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

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

Dokumentace GitHub

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

Aspose.3D FOSS pro TypeScript je knihovna licencovaná pod MIT pro práci s 3D formáty souborů v aplikacích Node.js. Nainstalujte ji jedním příkazem 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ý graf scén API postavený kolem Scene, Node, Entity, Mesh, Camera, Light a Transform, což je 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í i ASCII, plná obousměrná 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 TypeScript kompilátoru (noImplicitAny, strictNullChecks), takže vaše IDE poskytuje úplné automatické doplňování a bezpečnost při kompilaci. Její jediná runtime závislost, xmldom, se nainstaluje automaticky. Pro rodinu enterprise produktů viz Aspose.3D — Enterprise Product Family.

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

  • ** OBJ / MTL:** Nahrát soubory Wavefront OB J s doprovodnými definicemi materiálů.
  • glTF 2.0 / GLB: Nabití materiálu PBR a binární výstup z GBL prostřednictvím GltfSaveOptions.
  • STL: Číst a psát jak binární, tak ASCII STL s plným ověřováním z cesty zpět.
  • COLLADA, 3MF, FBX: Dodatečná podpora formátu s třídami pro jednotlivé varianty formatu.
  • Plné typy typopisu: Každá třída, metoda a možnost jsou silně zadané s noImplicitAny a strictNullChecks.

Kde se mohou použít Aspose.3D HNÁDY

  • Pipelines aktiv Node.js: Importovat soubory OBJ, ověřit a přeorientovat geometrii a exportovat jako GLB v CI.
  • Herní nástroje: 3D sítě bez nativního motoru nebo renderera.
  • Přeplacení 3D tisků: Číst, ověřovat a opětovně exportovat soubory STL a 3MF.
  • Bekendy bez serveru: Spouštějte koncovky 3D konverze v Lambda nebo Cloud Functions.
  • Migrace obsahu: Konverze mezi formatovými rodinami v měřítku z jednoho skriptu.

Možnosti formátu a kontrola koordinace

  • Orientace souřadnicového systému: Přepínat osy a upravovat stupnice podle formátu s možnými třídami.
  • Normalní normalizace: Automaticky normalizovat normály vrcholu při zatížení nebo uložení.
  • Dvojnásobný vs. JSON výstup: Vyberte kompaktní GLB nebo čitelné glTF prostřednictvím GltfSaveOptions.
  • Kontroly zatížení materiálu: Zahajte nebo deaktivujte MTL/teksturní zatěžování pro rychlejší analýzu.
  • Vrátit se: Neznámé scénové grafy jsou při opětovném ukládání doslova zachovány.

Zkušenosti vývojářů

Aspose.3D FOSS pro TypeScript se instaluje jediným příkazem npm install @aspose/3d. Není zde žádné nativní doplňky k kompilování. Knihovna je čistý Typopis/JavaScript s jednou automaticky nainstalovanou závislostí (xmldom).

Silně typovaná API poskytuje plné auto-kompletování IDE pro každou třídu a možnost formátu scény. Knihovna je zaměřena na Node.js 1822+ a TypeScript 5.0+, běží identicky v Linuxu CI runnery a vývojářské pracovní stanice, a je MIT licencovaný s otevřeným trackerem problému na GitHub .

Naložit scénu OBJ a exportovat jako glTF

Instalujte s npm, pak použít scene.open() se ObjLoadOptions na načtení síť spolu s jeho MTL soubor materiálů. Oba open() a save() jsou synchronní no await nebo Promise řetězce je potřeba. Volání scene.save() s rozšíření .gltf píše standardní glTF 2.0 JSON ?? formát je automaticky odvoděn z rozšíření 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");

Konverze STL na binární GLB

Pro vytvoření kompaktního binárního GLB místo standardní JSON glTF, přejděte GltfSaveOptions s binaryMode = true. Oba open() a save() jsou synchronní není potřeba žádného 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?

Je to bezplatná knihovna TypeScript/Node.js s licencí MIT pro načítání, manipulaci a ukládání 3D scén bez instalace jakéhokoli nativního addonu 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á vyhrazenou třídu typovaných možností.

Vyžaduje to nativní Node.js addony?

Ne. Aspose.3D FOSS pro TypeScript je čistý JavaScript/TypeScript. nevyžaduje žádný krok kompilace a má jedinou závislost na čase běhu (xmldom) automaticky instalovanou pomocí npm.

Jak to mám nainstalovat?

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

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

Node.js 18, 20 a 22+. TypeScript 5.0+ Knihovna kompiluje do CommonJS a pracuje se přísnými nastavením Typiskripta.

Má definice typů TypeScript?

Ano. Všechny třídy, metody, enumy a typy možností jsou plně zadané s noImplicitAny a strictNullChecks aktivovány.

Můžu ovládat orientaci souřadnicového systému?

Ano. Klasi pro formátní možnosti, jako jsou ObjLoadOptions a GltfSaveOptions vám umožňují otočit osy, upravovat stupnice a normalizovat normály bez vlastního parsingového kódu.

Kde najdu zdrojový kód?

Knihovna je licencovaná MIT a hostována na GitHub. Zprávy o chybách a žádosti o vytáhnutí jsou vítány.

  

Podpora a vzdělávací materiály

 Čeština