Začínáme

Aspose.3D FOSS pro Python

Vítejte v Aspose.3D FOSS pro Python, volná knihovna s licencí MIT pro načítání, vytváření a exportování 3D scén z Python. Tento průvodce vás provede od čerstvého prostředí až po funkční scénu během několika minut.

Požadavky

Před instalací se ujistěte, že vaše prostředí splňuje tyto požadavky:

Verze Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython je referenční interpret; všech šest verzí je testováno u každého vydání

Správce balíčků

  • pip (součástí všech moderních instalací Python)
  • Nejsou vyžadovány žádné další nástroje pro sestavení, kompilátory ani systémové balíčky

Operační systém

  • Windows, macOS a Linux jsou všechny podporovány
  • Knihovna je čistý Python: nevyžaduje žádné platformově specifické nativní rozšíření ke kompilaci

Instalace

Instalujte z PyPI pomocí pip:

pip install aspose-3d-foss

Viz Instalační příručku pro nastavení virtuálního prostředí, ověřovací kroky a rychlý ukázkový kód.

Aspose.3D FOSS pro Python

Po instalaci můžete okamžitě:

  • Načíst soubory OBJ (s podporou materiálů .mtl), STL, glTF 2.0, GLB, COLLADA a 3MF
  • Prozkoumat hierarchie scén: procházet uzly, číst sítě, přistupovat k normálám vrcholů a UV souřadnicím
  • Transformovat scény: aplikovat pozice, rotace (pomocí Quaternion), a měřítka pomocí Transform
  • Aplikovat materiály: pracovat s LambertMaterial a PhongMaterial na uzlech scény
  • Exportovat do libovolného podporovaného formátu s možnostmi ukládání pro každý formát
  • Vypočítat geometrii: dotazovat o ohraničující rámečky, akumulovat transformace ve světovém prostoru s GlobalTransform
  • Načíst animaci: přístup AnimationClip a KeyframeSequence data z načtených souborů glTF a COLLADA

Rychlý start

Následující kód načte soubor scény, vypíše potomky kořenového uzlu a znovu uloží scénu ve formátu GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Další kroky

 Čeština