Entwicklerhandbuch

Aspose.3D FOSS for Python ist eine Open‑Source‑Bibliothek unter der MIT‑Lizenz, die Python-Entwicklern das Laden, Erstellen, Transformieren und Exportieren von 3D‑Szenen ohne externe Laufzeitabhängigkeiten ermöglicht. Egal, ob Sie eine Asset‑Pipeline, ein Validierungstool, ein Geometrieverarbeitungs‑Skript oder einen Format‑Konvertierungsservice erstellen, bietet diese Bibliothek eine saubere, konsistente API, die von einem Szenengraph‑Modell unterstützt wird und branchenübliche 3D‑Konzepte widerspiegelt.

Dieses Entwicklerhandbuch deckt alles ab, was Sie benötigen, um über die Schnellstart‑Installation hinauszugehen und produktionsreife 3D‑Verarbeitungscode zu schreiben.

Was Sie in diesem Abschnitt finden werden

Funktionen und Merkmale

Der Funktionen Seite ist die primäre Referenz für die Arbeit mit Aspose.3D FOSS für Python. Sie deckt ab:

  • Formatunterstützung: OBJ (mit .mtl-Materialien), STL (binär und ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF und der in Arbeit befindliche FBX-Tokenizer, mit Klassen für Lade- und Speicheroptionen pro Format.
  • Szenengraph: Wie Scene, Node, Entity, Transform, und GlobalTransform in eine vollständige Szenenhierarchie komponieren, einschließlich Traversierungsmustern für Kindknoten.
  • Mesh API: Arbeiten mit control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, und VertexElementSmoothingGroup für die Geometrieverarbeitung.
  • Materialsystem: Anwenden LambertMaterial und PhongMaterial zu Szenenknoten und das Lesen von Materialeigenschaften, die aus .mtl-Dateien geladen wurden.
  • Mathe‑Hilfsprogramme: Verwenden Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, und BoundingBox für Transformationen, Bounding-Box-Abfragen und geometrische Berechnungen.
  • Animation: Erstellen und Lesen AnimationClip, AnimationNode, KeyFrame, und KeyframeSequence Daten.
  • Lade- und Speicheroptionen: Pro-Format-Optionklassen wie ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Vollständige Anwendungsbeispiele: End-to-End Python-Skripte zum Laden von OBJ, Exportieren von STL, Round-Trip von glTF und Durchlaufen von Szenengraphen.
  • Tipps, häufige Probleme und FAQ: Praktische Anleitung zur Vermeidung häufiger Fallstricke im Produktionseinsatz.
  • API-Referenzzusammenfassung: Kurzreferenzliste aller wichtigen Klassen.

Wichtige Konzepte

Szenengraph: Alle 3D-Inhalte in Aspose.3D FOSS werden als Baum von Node Objekten, die bei scene.root_node. Jeder Knoten kann ein Entity (wie ein Mesh, Camera, oder Light) und ein Transform die es in der Hierarchie positioniert.

Format-agnostische API: Sie öffnen jedes unterstützte Format über Scene.open() oder Scene.from_file() und speichere über jedes unterstützte Format Scene.save(). Die gleichen Szenengraph-Objekte werden unabhängig vom Quell- oder Zielformat verwendet.

Keine Abhängigkeiten: Die Bibliothek ist reines Python. Es gibt keine native Erweiterung zum Kompilieren, kein Systempaket zu installieren und keine Drittanbieter-Bibliothek zu verwalten.

Erste Schritte

Falls Sie die Bibliothek noch nicht installiert haben, siehe die Erste Schritte Abschnitt und das Installation Leitfaden, bevor Sie weiter lesen.

Verfügbare Themen

 Deutsch