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 pro TypeScript je knihovna licencovaná pod MIT, určená pro práci s 3D formáty souborů v aplikacích Node.js. Nainstalujte ji jediný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é API grafu scény postavené kolem Scene, Node, Entity, Mesh, Camera, Light a Transform, což je stejný konceptuální model používaný profesionálními 3D nástroji. Podporované formáty zahrnují 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á zpětná kompatibilita), COLLADA (DAE), 3MF a FBX. Třídy možností pro jednotlivé formáty, jako 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 kompletní automatické doplňování a bezpečnost během kompilace. Její jediná runtime závislost, xmldom, je instalována automaticky.

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

  • OBJ / MTL: Načtěte soubory Wavefront OBJ s přiloženými definicemi materiálů.
  • glTF 2.0 / GLB: Načítání PBR materiálů a binární výstup GLB pomocí GltfSaveOptions.
  • STL: Čtěte a zapisujte jak binární, tak ASCII STL s úplnou ověřením zpětné kompatibility.
  • 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 možnost je silně typována s noImplicitAny a strictNullChecks.

Kde lze použít Aspose.3D FOSS

  • Asset pipeline v Node.js: Importujte soubory OBJ, ověřte a přetočte geometrii a exportujte jako GLB v CI.
  • Nástroje pro hry: Hromadně zpracovávejte 3D sítě bez nativního enginu nebo rendereru.
  • Workflow pro 3D tisk: Čtěte, ověřujte a znovu exportujte soubory STL a 3MF.
  • Serverless backends: Spusťte koncové body pro 3D konverzi v Lambda nebo Cloud Functions.
  • Content migration: Převádějte mezi rodinami formátů ve velkém měřítku z jediného skriptu.

Možnosti pro jednotlivé formáty 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í.
  • Normalizace normál: 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.
  • Řízení načítání materiálů: 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 beze změny.

Zkušenost vývojáře

Aspose.3D FOSS pro instalace TypeScript s jediným příkazem npm install @aspose/3d. Nejsou žá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 scénového grafu a volbu formátu. Knihovna cílí na Node.js 18–22+ a TypeScript 5.0+, běží identicky na Linuxových CI běžcích i vývojářských pracovních stanicích a je licencována pod MIT s otevřeným systémem sledování problémů na GitHubu.

Načíst OBJ scénu a exportovat jako glTF

Nainstalujte pomocí npm, poté použijte synchronní metodu scene.open() s ObjLoadOptions k načtení sítě spolu s jejím MTL souborem materiálu. Volání scene.save() s příponou .gltf 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());

// Exportovat jako glTF 2.0 JSON
scene.save("model.gltf");

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

Pro vytvoření kompaktního binárního GLB místo výchozího JSON glTF předávejte GltfSaveOptions s binaryMode = true.

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 pod 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í i 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), která je nainstalována 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í převrátit osy, upravit 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