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, pure-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 Scene‑Graph‑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. Unterstützte Formate umfassen 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 Steuerung von Koordinaten‑Flip, 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. Es gibt keine native Erweiterung zum Kompilieren und kein Systempaket zu installieren.

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

  • OBJ / MTL: Laden Sie Wavefront‑OBJ‑Dateien mit zugehörigen Materialdefinitionen.
  • STL: Lesen und schreiben Sie sowohl binäre als auch ASCII‑STL mit vollständiger Rundreise‑Verifizierung.
  • glTF 2.0 / GLB: PBR‑Materialladen und binäre GLB‑Ausgabe über GltfSaveOptions.
  • COLLADA, 3MF, FBX: Zusätzliche Formatunterstützung mit pro‑Format‑Option‑Klassen.
  • Scene‑Graph‑API: Scene, Node, Mesh, Camera, Light, Transform.

Wo Aspose.3D FOSS verwendet werden kann

  • Asset‑Validierungspipelines: 3D‑Assets in CI prüfen, neu ausrichten und erneut exportieren.
  • Werkzeuge für die Spielentwicklung: OBJ/GLB‑Meshes stapelweise verarbeiten ohne native Engine.
  • 3D‑Druck‑Workflows: STL‑ und 3MF‑Dateien lesen, validieren und erneut exportieren.
  • Web-Backends: 3D-Konvertierungsendpunkte in Docker oder serverlosen Funktionen bereitstellen.
  • Content-Migration: Konvertieren Sie zwischen Formatfamilien in großem Umfang.

Optionen pro Format und Koordinatensteuerung

  • Koordinatensystemorientierung: Achsen umkehren und Skalierung pro Format anpassen, ohne benutzerdefinierten Code.
  • Normalen-Normalisierung: Vertex-Normalen beim Laden oder Speichern automatisch normalisieren.
  • Steuerung des Materialladens: MTL/Texture-Laden aktivieren oder deaktivieren für schnelleres Parsen.
  • Binär- vs. JSON-Ausgabe: Wählen Sie kompaktes GLB oder menschenlesbares glTF über Optionen.
  • Rundreise‑Treue: Die Szenengraph-Struktur bleibt über Lade‑ und Speicherzyklen erhalten (die Treue der Knoten‑Erhaltung ist formatabhängig und nicht für alle Formate unabhängig verifiziert).

Entwicklererfahrung

Aspose.3D FOSS für Python Installationen 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‑Werkzeuge wider, sodass die Lernkurve für alle, die mit Three.js oder dem Datenmodell von Blender vertraut sind, kurz ist. Die Bibliothek ist unter der MIT-Lizenz, Open‑Source, und begrüßt Fehlermeldungen sowie Beiträge auf GitHub.

Lade eine OBJ‑Szene und exportiere sie als glTF

Installieren Sie mit pip und rufen Sie dann Scene.open() mit ObjLoadOptions auf, um die OBJ‑Datei zusammen mit ihren MTL‑Materialdefinitionen zu laden. Ein einzelner Aufruf von scene.save() mit der Erweiterung .gltf schreibt eine glTF 2.0‑JSON‑Datei, ohne dass ein Format‑Register oder ein Konverter‑Objekt benötigt wird.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

# Laden Sie eine OBJ-Datei (mit .mtl-Materialien)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Exportieren als glTF 2.0
scene.save("model.gltf")

Konvertiere STL in ein binäres GLB mit Koordinatenumkehr

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

# Als binäres GLB speichern
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 Laufzeit‑ oder 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. Jedes Format hat eine eigene Lade‑/Speicher‑Optionen‑Klasse.

Benötigt es native Abhängigkeiten?

Nein. Aspose.3D FOSS für Python ist reines Python ohne native Erweiterungen. Es läuft unter 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. Pro-Format-Option‑Klassen ermöglichen das Vertauschen von Achsen, Anpassen der Skalierung und 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 und auf GitHub gehostet. Fehlermeldungen und Pull‑Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch