1. Produkte
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Python

Aspose.3D FOSS für Python

Laden, erstellen, transformieren und exportieren Sie 3D‑Szenen aus Python — kostenlos und Open-Source.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Dokumentation GitHub

Open-Source Python-Bibliothek für 3D-Dateiverarbeitung

Aspose.3D FOSS für Python ist eine MIT-lizenzierte, reine-Python Bibliothek zum Arbeiten mit 3D-Dateiformaten. Installieren Sie sie mit einem einzigen pip-Befehl und beginnen Sie sofort mit dem Lesen, Erstellen und Schreiben von 3D‑Szenen, ohne eine native Laufzeit, ein externes SDK oder einen Drittanbieter‑Renderer zu installieren.

Die Bibliothek stellt eine saubere Szenengraph‑API bereit, die um Scene, Node, Mesh, Camera, Light und Transform herum aufgebaut ist, dem gleichen konzeptuellen Modell, das von professionellen 3D‑Tools verwendet wird. Die Formatunterstützung umfasst OBJ (mit .mtl‑Materialladen), STL (binär und ASCII, Rundreise verifiziert), glTF 2.0 / GLB (PBR‑Materialien), COLLADA (DAE), 3MF und FBX. Pro‑Format‑Lade‑ und Speicheroptionen ermöglichen die Kontrolle von Koordinatenumkehr, Skalierung, Normalen‑Normalisierung und Materialladen, ohne format‑spezifischen Parsing‑Code zu schreiben.

Aspose.3D FOSS unterstützt Python 3.7 bis 3.12 und läuft identisch auf Windows-, macOS- und Linux-CI-Runnern, Docker-Containern und serverlosen Umgebungen. Für Unternehmensfunktionen und Support siehe Aspose.3D for Python — Enterprise Product.

Unterstützung für 3D-Formate und Scene-Graph-API

  • OBJ / MTL: Wavefront OBJ-Dateien mit zugehörigen Materialdefinitionen laden.
  • STL: Lesen und Schreiben von binären und ASCII STL mit vollständiger Roundtrip‑Überprüfung.
  • glTF 2.0 / GLB: PBR-Materialladen und binäre GLB-Ausgabe über GltfSaveOptions.
  • COLLADA, 3MF, FBX: Zusätzliche Formatunterstützung mit pro‑Format‑Optionklassen.
  • Scene-graph API: Scene, Node, Mesh, Camera, Light, Transform.

Wo Aspose.3D FOSS verwendet werden kann

  • Asset-Validierungspipelines: Verifizieren, neu ausrichten und 3D-Assets im CI erneut exportieren.
  • Werkzeuge für die Spieleentwicklung: Batch-Verarbeitung von OBJ/GLB-Meshes ohne native Engine.
  • 3D-Druck-Workflows: Lesen, validieren und erneut exportieren von STL- und 3MF-Dateien.
  • Web-Backends: 3D-Konvertierungsendpunkte in Docker oder serverlosen Funktionen bereitstellen.
  • Inhaltsmigration: Konvertieren zwischen Formatfamilien in großem Umfang.

Optionen pro Format und Koordinatensteuerung

  • Koordinatensystemorientierung: Achsen umkehren und Skalierung pro Format anpassen, ohne benutzerdefinierten Code.
  • Normalnormalisierung: Normalisieren Sie automatisch Vertex-Normalen beim Laden oder Speichern.
  • Material-Ladekontrolle: Aktivieren oder deaktivieren Sie das Laden von MTL/texture für schnellere Analyse.
  • Binär vs. JSON Ausgabe: Wählen Sie kompakte GLB oder menschenlesbare glTF über Optionen.
  • Rundweg-Treue: Die Szenengraph-Struktur wird über Lade- und Speicherzyklen hinweg beibehalten (die Knoten‑Erhaltungs‑Treue ist formatabhängig und nicht für alle Formate unabhängig verifiziert).

Entwicklererfahrung

Aspose.3D FOSS für Python installiert sich mit einem einzigen pip install aspose-3d-foss-Befehl. Die Bibliothek ist reines Python, ohne native Erweiterungen zum Kompilieren und ohne Systempakete zu installieren.

Die Scene-Graph-API spiegelt das konzeptionelle Modell professioneller 3D-Tools wider, sodass die Lernkurve für alle, die mit Three.js oder dem Datenmodell von Blender vertraut sind, kurz ist. Die Bibliothek ist MIT-licensed, open-source und begrüßt Fehlermeldungen und Beiträge auf GitHub.

Lade eine OBJ‑Szene und exportiere sie als glTF

Installieren Sie mit pip, dann rufen Sie Scene.open() mit ObjLoadOptions auf, um die OBJ-Datei zusammen mit ihren MTL-Materialdefinitionen zu laden. Ein einzelner scene.save()-Aufruf mit einer .gltf-Erweiterung schreibt eine glTF 2.0 JSON-Datei — kein Format-Register oder Konverterobjekt erforderlich.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

STL in Binary GLB mit Koordinatenumkehr konvertieren

Um ein kompaktes binäres GLB anstelle des standardmäßigen JSON glTF zu erzeugen, übergeben Sie eine GltfSaveOptions-Instanz mit binary_mode = True. Das gleiche Muster gilt für Koordinatensystem‑Anpassungen — tauschen Sie die Optionsklasse gegen das Format aus, das Sie anvisieren.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Häufig gestellte Fragen

Was ist Aspose.3D FOSS für Python?

Es ist eine kostenlose, MIT-lizenzierte pure-Python Bibliothek zum Laden, Manipulieren und Speichern von 3D‑Szenen, ohne dass ein natives Laufzeitumfeld oder ein externes SDK installiert werden muss.

Welche 3D-Formate werden unterstützt?

OBJ (mit .mtl), STL (binär und ASCII), glTF 2.0 und GLB, COLLADA (DAE), 3MF und FBX. Für jedes Format gibt es eine dedizierte load/save options class.

Benötigt es native Abhängigkeiten?

Nein. Aspose.3D FOSS für Python ist reines Python ohne native Erweiterungen. Es läuft auf Windows, macOS und Linux ohne einen Kompilierungsschritt.

Wie installiere ich es?

Führen Sie pip install aspose-3d-foss aus. Es werden keine zusätzlichen Systempakete oder nativen Erweiterungen benötigt.

Kann ich die Orientierung des Koordinatensystems steuern?

Ja. Per-Format-Optionklassen ermöglichen das Spiegeln von Achsen, das Anpassen der Skalierung und das Normalisieren von Normalen, ohne format-spezifischen Parsing‑Code schreiben zu müssen.

Welche Python-Versionen werden unterstützt?

Python 3.7 bis 3.12 werden unterstützt. Die Bibliothek läuft identisch auf allen gängigen Betriebssystemen.

Ist der Quellcode verfügbar?

Ja. Die Bibliothek ist unter der MIT-Lizenz veröffentlicht und auf GitHub gehostet. Fehlerberichte und Pull‑Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch