Príručka pre vývojárov

Aspose.3D FOSS pre TypeScript je open-source knižnica s licenciou MIT, ktorá umožňuje vývojárom Node.js načítať, konštruovať, transformovať a exportovať 3D scény s úplnou typovou bezpečnosťou TypeScriptu. Či už budujete pipeline pre assety, službu na konverziu formátov, nástroj na validáciu geometrie alebo skript na tvorbu 3D obsahu, táto knižnica poskytuje čisté, konzistentné API podporované modelom scény grafu, ktorý odráža priemyselne štandardné 3D koncepty.

Tento vývojársky sprievodca pokrýva všetko, čo potrebujete na prekročenie rýchlej inštalácie a písanie 3D spracovateľského kódu v produkčnej kvalite.

Čo nájdete v tejto sekcii

Funkcie a vlastnosti

The Funkcie stránka je primárnym referenčným materiálom pre prácu s Aspose.3D FOSS pre TypeScript. Pokrýva:

  • Podpora formátov: OBJ (s .mtl materiálmi), glTF 2.0 / GLB binárny, STL (binárny a ASCII), COLLADA (DAE), 3MF a FBX, s triedami pre načítanie a uloženie pre každý formát vrátane ObjLoadOptions a GltfSaveOptions.
  • Scénový graf: Ako Scene, Node, Entity, Transform, SceneObject sa zloží do úplnej hierarchie scény, vrátane vzorov prechádzania poduzlami.
  • Geometrické a sieťové API: Práca s Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode pre spracovanie geometrie.
  • Materiálový systém: Aplikovanie LambertMaterial, PhongMaterial, a PbrMaterial (PBR pre glTF) do uzlov scény, a čítanie vlastností materiálu načítaných zo súborov .mtl.
  • Matematické nástroje: Používanie Vector3, Vector4, Matrix4, Quaternion, a BoundingBox pre transformácie, dotazy na ohraničujúce boxy a geometrické výpočty.
  • Animácia: Vytváranie a čítanie AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, a Extrapolation údaje.
  • Podpora streamov a bufferov: Načítanie 3D scén z pamäte Buffer objekty cez scene.openFromBuffer() pre serverless a streamingové prípady použitia.
  • Kompletné príklady použitia: End-to-end TypeScript skripty na načítanie OBJ, exportovanie GLB, round-tripping STL a prechádzanie grafov scény.
  • Tipy, bežné problémy a FAQ: Praktické usmernenia na vyhýbanie sa bežným úskokom v produkčnom použití.
  • Zhrnutie referencie API: Rýchly prehľad všetkých kľúčových tried a ich hlavných metód.

Kľúčové koncepty

Scénový graf: Všetok 3D obsah v Aspose.3D FOSS je reprezentovaný ako strom Node objektov zakorenených v scene.rootNode. Každý uzol môže niesť Entity (napríklad Mesh, Camera, alebo Light) Transform ktorý ho umiestňuje v hierarchii.

Formátovo agnostické API: Otvoríte akýkoľvek podporovaný formát cez scene.open() alebo scene.openFromBuffer() a uložíte do akéhokoľvek podporovaného formátu cez scene.save().

Silné typovanie TypeScript: Knižnica je dodávaná s prísnymi nastaveniami kompilátora (noImplicitAny, strictNullChecks) a kompletné definície typov. Každá trieda, metóda a vlastnosť možnosti je plne typovaná, čo vám poskytuje automatické dopĺňanie v IDE a bezpečnosť počas kompilácie po celú dobu vášho 3D spracovateľského kódu.

Jedna závislosť: Jedinou runtime závislosťou je xmldom, ktorá sa inštaluje automaticky cez npm. Neexistujú žiadne natívne doplnky na kompiláciu ani žiadne systémové balíky na inštaláciu.

Začíname

Ak ste ešte knižnicu nenainštalovali, pozrite si Začíname sekcia a Inštalácia príručka pred ďalším čítaním.

Dostupné témy

  • Funkcie a vlastnosti: Kompletná referenčná dokumentácia API s príkladmi kódu pre každú hlavnú funkčnú oblasť.
 Slovenčina