Úvodní článek
Jsme rádi, že oznamujeme dostupnost 3D FOSS pro TypeScript jako v případě: @aspose/3d Tato knihovna s licencí MIT přináší 3D zpracování scén ve výrobní kvalitě do aplikací TypeScript a Node.js bez nutnosti nativních binárů, platformově specifických toolchains nebo komerčních licenci.
Knihovna je navržena na základě přímého, jednoduchého a praktického přístupu k informačním technologiím. Scene API: načítání 3D souboru s scene.open(), zkontrolovat nebo transformovat scénový graf, a napsat výsledek s scene.save().Úplné definice typů TypeScript jsou shromážděny; žádné samostatné . @types/ je nutný balíček.
Klíčové prvky
Multifomátové vstupy a výstupy. Objekty jsou také vybaveny 3D formátem, který je součástí balíku. OBJ, glTF 2.0, GLB, STL, 3MF a COLLADA podporují jak import, tak export. Existují třídy FBX dovozce/exportér ale automatické detekci formátu ještě není možné nainstalovat, takže soubory FBx nelze načíst prostřednictvím systému FBS. scene.open().
První třída TypeScript podpory. Všechny veřejné třídy, výčty a typy možností jsou plně typované. IDE s podporou jazykových služeb TypeScript (VS Code, WebStorm atd.) poskytují přesné automatické dokončení a inline dokumentaci pro každý výzvu API.
Node.js 18–22+ compatibility. Paket je testován proti verzi Node.js 18, 20 a 22 LTS. Při instalaci nejsou kompilovány žádné nativní doplňky, takže funguje na všech platformách podporovaných Node .js.
Jedna závislost na čase. Jediná závislost je … xmldom, používané výhradně pro analýzu COLLADA XML. Všechny ostatní formátové analyzátory jsou čisté implementace JavaScriptu.
Licence MIT. Použití: @aspose/3d v komerčních, open-source nebo interních projektech bez omezení.
Rychlý start
Nainstalujte balíček:
asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.Nahrát soubor OBJ a převést ho na binární GLB:
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';
const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true; // produce a single .glb file
scene.save('output.glb', GltfFormat.getInstance(), saveOpts);
console.log('Converted to GLB successfully');
Iterovat přes uzly scény pro kontrolu geometrie:
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());
for (const node of scene.rootNode.childNodes) {
console.log(`Node: ${node.name}`);
if (node.entity) {
console.log(` Entity type: ${node.entity.constructor.name}`);
}
}
Podporované formáty
| Formát | Rozšíření | Dovoz | Vývoz | Poznámky |
|---|---|---|---|---|
| OBJ | .obj | Ano , ano . | Ano , ano . | Objektování na vlnové čele; čte/píšete .mtl materiální soubory |
| glTF | .gltf / .glb | Ano , ano . | Ano , ano . | binární JSON a GLB v rámci glTF 2.0 |
| STL | .stl | Ano , ano . | Ano , ano . | ASCII a binární STL |
| 3MF | .3mf | Ano , ano . | Ano , ano . | Archiv Open Packaging Convention (Otevřené balení) |
| FBX | .fbx | Ne* | Ne* | Existují dovozci/vývozci, ale formát automatického detekce není propojený. |
| COLLADA | .dae | Ano , ano . | Ano , ano . | Požadavky v souboru xmldom závislost |
Výhody typopisu
Práce s @aspose/3d v TypeScript zachytí chyby kategorie při kompilaci spíše než během běhu. Když voláte scene.save(), kompilátor ověří, že objekt opcí odpovídá očekávanému SaveOptions Podtyp pro vybraný formát. Možnosti načítání a ukládání specifické pro daný format odhalují pouze vlastnosti relevantní pro tento formátu; není zde žádný pytel s nevytištěnými možnostmi, na který by se dalo hádat.
Například:, GltfSaveOptions.binaryMode je typovaný boolean, takže kompilátor odmítá saveOpts.binaryMode = 'yes' animované vlastnosti na AnimationClip, materiální kanály na PbrMaterial, a typy vrcholu na VertexElement jsou všechny podobně zadané a lze je objevit prostřednictvím IntelliSense bez konzultace s externí dokumentací.
Open Source (v otevřeném zdrojovém jazyce)
Tento balíček je zveřejněn pod názvem: Licence MIT.Příspěvky, zprávy o chybách a požadavky na podporu formátu jsou vítány prostřednictvím sledovače problémů úložiště.
Knihovna má jednu závislost na čase běhu: xmldom (^0.6.0Všechny ostatní parsery a writery jsou samostatné čisté JavaScript implementace bez binárních komponent.
Jak začít?
- npm:
npm install @aspose/3d - Základní znalosti: Jak načítat 3D modely do TypeScriptu
- Základní znalosti: Jak exportovat 3D scény do GLTF/GLB v TypeScript
- Odkaz na API: Aspose.3D FOSS pro TypeScript: Reference plné třídy
- GitHub: Aspose-3d/aspose-3D-základní uzel
Výsledky
@aspose/3d Verze 24.12.0 poskytuje stabilní, typovaný základ pro zpracování 3D souborů v TypeScript a Node.js. Ať už je případ použití konverzí formátu, inspekce scén, extrakce geometrie nebo integrace potrubí, knihovna pokrývá nejběžnější formáty výměny 3d pod přípustnou open-source licencí.
Nainstaluj to dnes a dej nám vědět, co budeš stavět.