Vývojářská příručka

Aspose.3D FOSS pro TypeScript je open-source, MIT licencovaná knihovna, která umožňuje vývojářům Node.js načítat, stavět, transformovat a exportovat 3D scény s plnou bezpečností typu TypeScript. Ať už vytváříte plynovod, službu konverze formátů, nástroj pro ověřování geometrie nebo skript pro tvorbu 3D obsahu, tato knihovna poskytuje čistý, konzistentní API podporovaný modelem scénového grafu, který odráží průmyslové standardní 3D koncepty.

Tato příručka pro vývojáře pokrývá vše, co potřebujete k překročení rychlé instalace a psaní výrobního 3D zpracování kódu.

Co najdete v této sekci

Funkce a funkce

The Funkce stránka je hlavním referenčním zdrojem pro práci s Aspose.3D FOSS pro TypeScript. Pokrývá:

  • Podpora formátů: OBJ (s materiály .mtl), glTF 2.0 / GLB binární, STL (binární a ASCII), COLLADA (DAE), 3MF a FBX, s třídami pro načítání a ukládání pro každý formát včetně ObjLoadOptions a GltfSaveOptions.
  • Scénový graf: Jak Scene, Node, Entity, Transform, SceneObject se skládá do úplné hierarchie scény, včetně vzorů procházení podřízených uzlů.
  • Geometrické a síťové API: Práce s Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode pro zpracování geometrie.
  • Materiálový systém: Aplikace LambertMaterial, PhongMaterial, a PbrMaterial (PBR pro glTF) do uzlů scény, a čtení vlastností materiálu načtených ze souborů .mtl.
  • Matematické utility: Použití Vector3, Vector4, Matrix4, Quaternion, a BoundingBox pro transformace, dotazy na ohraničující rámeček a geometrické výpočty.
  • Animace: Vytváření a čtení AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, a Extrapolation data.
  • Podpora streamu a bufferu: Načítání 3D scén z paměti Buffer objektů pomocí scene.openFromBuffer() pro serverless a streamingové případy použití.
  • Kompletní příklady použití: Kompletní TypeScript skripty pro načítání OBJ, export GLB, zpětné převádění STL a procházení grafů scény.
  • Tipy, běžné problémy a FAQ: Praktické rady pro vyhnutí se běžným úskalím v produkčním použití.
  • Přehled API reference: Rychlý přehled všech klíčových tříd a jejich hlavních metod.

Klíčové pojmy

Scénový graf: Veškerý 3D obsah v Aspose.3D FOSS je reprezentován jako strom Node objektů zakořeněných v scene.rootNode. Každý uzel může nést Entity (například Mesh, Camera, nebo Light) Transform který jej umisťuje do hierarchie.

Formátově agnostické API: Otevřete libovolný podporovaný formát pomocí scene.open() nebo scene.openFromBuffer() a uložíte do libovolného podporovaného formátu pomocí scene.save(). Stejné objekty scény‑grafu jsou používány bez ohledu na zdrojový nebo cílový formát.

Silné typování v TypeScriptu: Knihovna je dodávána s přísnými nastaveními kompilátoru (noImplicitAny, strictNullChecks).

Jedna závislost: Jedinou runtime závislostí je xmldom, který je automaticky instalován pomocí npm. Neexistují žádné nativní doplňky ke kompilaci ani žádné systémové balíčky k instalaci.

Začínáme

Pokud knihovnu ještě neinstalovali, podívejte se na Začínáme sekce a Instalace průvodce před dalším čtením.

Dostupná témata

  • Funkce a funkce: Kompletní referenční příručka API s ukázkovým kódem pro každou hlavní oblast funkcí.
 Čeština