Príručka pre vývojárov

Aspose.3D FOSS pre Python je open-source knižnica pod licenciou MIT, ktorá umožňuje vývojárom Python načítať, konštruovať, transformovať a exportovať 3D scény bez akýchkoľvek externých runtime závislostí. Či už budujete pipeline pre aktíva, validačný nástroj, skript na spracovanie geometrie alebo službu na konverziu formátov, táto knižnica poskytuje čisté, konzistentné API podporované modelom grafu scény, ktorý odráža priemyselne štandardné 3D koncepty.

Táto príručka pre vývojárov pokrýva všetko, čo potrebujete na prekročenie rýchlej inštalácie a písanie 3D spracovateľského kódu produkčnej kvality.

Č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 Python. Pokrýva:

  • Podpora formátov: OBJ (s .mtl materiálmi), STL (binárny a ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF a prebiehajúci FBX tokenizér, s triedami možností načítania a ukladania pre každý formát.
  • Scénový graf: Ako Scene, Node, Entity, Transform, a GlobalTransform zostavte úplnú hierarchiu scény, vrátane vzorov prechádzania poduzlami.
  • Mesh API: Práca s control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, a VertexElementSmoothingGroup pre spracovanie geometrie.
  • Materiálový systém: Aplikovanie LambertMaterial a PhongMaterial k uzlom scény a čítaniu vlastností materiálu načítaných zo súborov .mtl.
  • Matematické nástroje: Používanie Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, a BoundingBox pre transformácie, dotazy na ohraničujúce rámce a geometrické výpočty.
  • Animácia: Vytváranie a čítanie AnimationClip, AnimationNode, KeyFrame, a KeyframeSequence dáta.
  • Možnosti načítania a ukladania: Triedy možností pre jednotlivé formáty, ako napríklad ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Kompletné príklady použitia: Kompletné Python skripty na načítanie OBJ, exportovanie STL, round-tripping glTF a prechádzanie grafov scény.
  • Tipy, bežné problémy a FAQ: Praktické usmernenia na vyhýbanie sa bežným úskokom pri produkčnom používaní.
  • Zhrnutie referencie API: Zoznam rýchlej referencie všetkých kľúčových tried.

Kľúčové koncepty

Graf scény: Všetok 3D obsah v Aspose.3D FOSS je reprezentovaný ako strom of Node objektov zakorenených v scene.root_node. Každý uzol môže niesť Entity (napríklad a Mesh, Camera, alebo Light) a Transform čo ho umiestňuje v hierarchii.

Formátovo agnostické API: Otvoríte akýkoľvek podporovaný formát cez Scene.open() alebo Scene.from_file() a uložíte do akéhokoľvek podporovaného formátu cez Scene.save(). Rovnaké objekty scene-graph sa používajú bez ohľadu na zdrojový alebo cieľový formát.

Žiadne závislosti: Knižnica je čistá Python. Neexistuje žiadne natívne rozšírenie na kompiláciu, žiadny systémový balík na inštaláciu a žiadna knižnica tretích strán na správu.

Začíname

Ak ste ešte nenainštalovali knižnicu, pozrite si Začíname sekciu a Inštalácia príručku 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