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

Aspose.3D FOSS pro Python je open-source knihovna s licencí MIT, která umožňuje vývojářům Python načítat, konstruovat, transformovat a exportovat 3D scény bez jakýchkoli externích runtime závislostí. Ať už vytváříte pipeline pro assety, validační nástroj, skript pro zpracování geometrie nebo službu pro konverzi formátů, tato knihovna poskytuje čisté, konzistentní API podpořené modelem scénového grafu, který odráží průmyslové standardy 3D konceptů.

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

Co v této sekci najdete

Funkce a vlastnosti

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

  • Podpora formátů: OBJ (s .mtl materiály), STL (binární a ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF a probíhající tokenizér FBX, s třídami možností načítání a ukládání pro každý formát.
  • Scénový graf: Jak Scene, Node, Entity, Transform, a GlobalTransform sestavte do úplné hierarchie scény, včetně vzorů procházení podřízených uzlů.
  • Mesh API: Práce s control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, a VertexElementSmoothingGroup pro zpracování geometrie.
  • Materiálový systém: Použití LambertMaterial a PhongMaterial k uzlům scény, a čtení materiálových vlastností načtených ze souborů .mtl.
  • Matematické utility: Používání Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, a BoundingBox pro transformace, dotazy na ohraničující rámeček a geometrické výpočty.
  • Animace: Vytváření a čtení AnimationClip, AnimationNode, KeyFrame, a KeyframeSequence data.
  • Možnosti načítání a ukládání: Třídy možností pro jednotlivé formáty, jako například ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Kompletní příklady použití: Kompletní Python skripty pro načítání OBJ, exportování STL, round-tripping glTF a procházení grafů scén.
  • Tipy, běžné problémy a FAQ: Praktické pokyny pro vyhnutí se běžným úskalím při produkčním použití.
  • Shrnutí referenčního API: Přehledný seznam všech klíčových tříd.

Klíčové koncepty

Graf scény: Veškerý 3D obsah v Aspose.3D FOSS je reprezentován jako strom Node objektů s kořenem v scene.root_node. Každý uzel může nést Entity (například Mesh, Camera, nebo Light) a Transform což jej umisťuje v hierarchii.

Formátově agnostické API: Otevřete libovolný podporovaný formát pomocí Scene.open() nebo Scene.from_file() 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.

Žádné závislosti: Knihovna je čistá Python. Neexistuje žádné nativní rozšíření ke kompilaci, žádný systémový balíček k instalaci ani žádná knihovna třetí strany k správě.

Začínáme

Pokud jste dosud nenainstalovali knihovnu, podívejte se na Začínáme sekci a Instalace průvodce před dalším čtením.

Dostupná témata

  • Funkce a vlastnosti: Kompletní referenční příručka API s ukázkami kódu pro každou hlavní oblast funkcí.
 Čeština