Erste Schritte

Aspose.3D FOSS für Python

Willkommen bei Aspose.3D FOSS für Python, eine kostenlose, MIT-lizenzierte Bibliothek zum Laden, Erstellen und Exportieren von 3D‑Szenen aus Python. Dieser Leitfaden führt Sie von einer frischen Umgebung zu einer funktionierenden Szene in wenigen Minuten.

Voraussetzungen

Stellen Sie vor der Installation sicher, dass Ihre Umgebung diese Anforderungen erfüllt:

Python Version

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython ist der Referenzinterpreter; alle sechs Versionen werden bei jeder Veröffentlichung getestet

Paketmanager

  • pip (im Lieferumfang aller modernen Python-Installationen enthalten)
  • Keine weiteren Build-Tools, Compiler oder Systempakete sind erforderlich

Betriebssystem

  • Windows, macOS und Linux werden alle unterstützt
  • Die Bibliothek ist reines Python: keine plattformspezifische native Erweiterung zum Kompilieren erforderlich

Installation

Installation von PyPI mit pip:

pip install aspose-3d-foss

Siehe die Installationsanleitung für die Einrichtung einer virtuellen Umgebung, Verifizierungsschritte und ein Schnellstart‑Codebeispiel.

Aspose.3D FOSS für Python

Nach der Installation können Sie sofort:

  • Laden OBJ (mit .mtl-Materialunterstützung), STL, glTF 2.0, GLB, COLLADA und 3MF-Dateien
  • Untersuchen Szenenhierarchien: Knoten durchlaufen, Meshes lesen, auf Vertex-Normalen und UVs zugreifen
  • Transformation Szenen: Positionen, Rotationen (über Quaternion), und Skalierungen mit Transform
  • Materialien anwenden: arbeiten mit LambertMaterial und PhongMaterial auf Szenenknoten
  • Exportieren in jedes unterstützte Format mit formatbezogenen Speicheroptionen
  • Geometrie berechnen: Abfrage von Bounding-Boxen, Akkumulieren von World-Space-Transformationen mit GlobalTransform
  • Animation lesen: Zugriff AnimationClip und KeyframeSequence Daten aus geladenen glTF- und COLLADA-Dateien

Schnellstart

Der folgende Code lädt eine Szenendatei, gibt die Kinder des Wurzelknotens aus und speichert die Szene im GLB‑Format erneut:

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")

Nächste Schritte

 Deutsch