Rozpoczęcie

Aspose.3D FOSS dla Pythona

Witamy w Aspose.3D FOSS dla Python, darmowa, MIT-licensed biblioteka do ładowania, konstruowania i eksportowania scen 3D z Python. Ten przewodnik przeprowadzi Cię od świeżego środowiska do działającej sceny w kilka minut.

Wymagania wstępne

Przed instalacją upewnij się, że Twoje środowisko spełnia następujące wymagania:

Wersja Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython jest interpreterem referencyjnym; wszystkie sześć wersji są testowane przy każdym wydaniu

Menedżer pakietów

  • pip (dołączony do wszystkich nowoczesnych Python instalacji)
  • Nie są wymagane żadne inne narzędzia budowania, kompilatory ani pakiety systemowe

System operacyjny

  • Windows, macOS i Linux są wszystkie obsługiwane
  • Biblioteka jest czystym Python: nie wymaga platformowo-specyficznych natywnych rozszerzeń do kompilacji

Instalacja

Zainstaluj z PyPI przy użyciu pip:

pip install aspose-3d-foss

Zobacz Przewodnik instalacji do konfiguracji wirtualnego środowiska, kroków weryfikacji i przykładu szybkiego startu.

Aspose.3D FOSS dla Pythona

Po zainstalowaniu możesz od razu:

  • Ładuj pliki OBJ (z obsługą materiałów .mtl), STL, glTF 2.0, GLB, COLLADA i 3MF
  • Sprawdź hierarchie scen: przeglądaj węzły, odczytuj siatki, uzyskuj dostęp do normalnych wierzchołków i UV
  • Transformacja sceny: zastosuj pozycje, obroty (przez Quaternion), i skaluj używając Transform
  • Zastosuj materiały: pracuj z LambertMaterial i PhongMaterial na węzłach sceny
  • Eksportuj do dowolnego obsługiwanego formatu z opcjami zapisu specyficznymi dla formatu
  • Oblicz geometrię: zapytaj o ramki ograniczające, akumuluj przekształcenia w przestrzeni świata z GlobalTransform
  • Wczytaj animację: dostęp AnimationClip i KeyframeSequence dane z załadowanych plików glTF i COLLADA

Szybki start

Poniższy kod ładuje plik sceny, wypisuje dzieci węzła głównego i zapisuje scenę ponownie w formacie 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")

Kolejne kroki

 Polski