Render und Python-Automatisierung über die Kommandozeile in Blender 5.2 LTS

Das lernen Sie in diesem Leitfaden

Nicht jede Aufgabe in Blender muss über die Benutzeroberfläche erledigt werden. Über die Kommandozeile können Sie Renderings im Hintergrund erstellen und denselben Vorgang mit einem wiederholbaren Befehl starten. Die Python-API von Blender ermöglicht außerdem den Zugriff auf Objekte und andere Daten in der geöffneten Datei sowie das Erstellen einfacher Berichte.

In diesem Leitfaden verwenden wir die Renderoptionen aus der Kommandozeilendokumentation von Blender 5.2 LTS, um einen einzelnen Frame und eine Animation zu rendern. Anschließend erstellen wir mit der integrierten Python-Umgebung von Blender einen einfachen Szenenbericht und führen das Skript über die Kommandozeile aus. Die Beispiele setzen weder bestimmte Einstellungen in einer realen Szenendatei noch Hardwarekompatibilität voraus. Passen Sie die Befehle an Ihre Dateien und Renderanforderungen an.

Voraussetzungen

• Blender muss installiert sein. Die Befehlsbeispiele basieren auf der Kommandozeilendokumentation von Blender 5.2 LTS.

• Sie benötigen eine .blend-Datei, die gerendert werden soll, und Zugriff auf ihren Speicherort.

• Für die Kommandozeile benötigen Sie das Terminal Ihres Betriebssystems. Für das Python-Beispiel eignen sich der Arbeitsbereich Scripting, der Texteditor oder die Python Console von Blender.

• Für die Kommandozeilendokumentation wird kein Benutzerkonto vorausgesetzt. Die Blender-Python-API-Dokumentation weist darauf hin, dass die API im Allgemeinen stabil ist, einige Bereiche jedoch weiterentwickelt werden.

Schritt für Schritt: im Hintergrund rendern

1. Einen einzelnen Frame rendern

Mit -b oder --background wird Blender ohne Benutzeroberfläche gestartet. -f legt die Nummer des zu rendernden Frames fest, -o den Ausgabepfad und Dateinamen und -F das Ausgabeformat. Das folgende Beispiel rendert Frame 20 der Datei sahne.blend als PNG:

blender -b sahne.blend -o //render_ -F PNG -f 20

Ein Ausgabepfad mit // ist relativ zur .blend-Datei. Wenn der Dateiname kein # enthält, hängt Blender automatisch eine Nummerierung für den Frame an den Dateinamen an. Werden mehrere Frames erzeugt, können Sie mit # im Dateinamen die Stelle der Frame-Nummer und ihre Auffüllung mit Nullen festlegen.

2. Die Animation im Frame-Bereich der Szene rendern

-a oder --render-anim rendert die Animation zwischen Start- und Endframe; beide Frames sind eingeschlossen. Im folgenden Beispiel ist der Ausgabepfad relativ und das Format PNG:

blender -b sahne.blend -o //animasyon_## -F PNG -a

Mit -s und -e lassen sich Start- und Endframe separat festlegen. -j bestimmt, um wie viele Frames zwischen den zu rendernden Frames weitergesprungen wird. Prüfen Sie dabei den Frame-Bereich der Szene und das gewünschte Sampling der Frames. Wenn nur die erforderlichen Frames gerendert werden, lässt sich das Ausgabeverzeichnis leichter verwalten.

-x oder --use-extension bestimmt, ob die Dateierweiterung an die Ausgabe angehängt wird. Um das Anhängen der Erweiterung ausdrücklich zu aktivieren, können Sie wie im Dokumentationsbeispiel -x 1 verwenden. JPEG, PNG, TIFF und HDR gehören zu den aufgeführten Formaten. Ob einige Formate verfügbar sind, kann von der kompilierten Blender-Version abhängen.

3. Render-Engine, Threads und Cycles-Gerät auswählen

Mit -E lässt sich die Render-Engine angeben; -E help listet die verfügbaren Engines auf. -t legt die Anzahl der Threads für Rendering und andere Vorgänge fest. Der Wert 0 bewirkt, dass Blender die Anzahl der Prozessoren im System verwendet.

Die Option für das Cycles-Gerät wird nach den regulären Kommandozeilenoptionen von Blender durch zwei Bindestriche abgetrennt. In der Dokumentation sind CPU, CUDA, OPTIX, HIP, ONEAPI und METAL aufgeführt. Gehen Sie nicht davon aus, dass diese Optionen auf dem Zielrechner funktionieren; überprüfen Sie die Auswahl auf dem jeweiligen System mit der installierten Blender-Version.

blender -b sahne.blend -f 20 -- --cycles-device OPTIX --cycles-print-stats

In diesem Beispiel wird für Cycles das Gerät OPTIX ausgewählt und Blender angewiesen, Statistiken zur Speichernutzung und Renderzeit auszugeben. Wird an den Namen des GPU-Geräts +CPU angehängt, bedeutet das, dass GPU und CPU gemeinsam verwendet werden. Wenn nicht Cycles als Render-Engine zum Einsatz kommt, sollten Sie statt einer Cycles-spezifischen Geräteoption die Optionen der jeweiligen Engine prüfen.

4. Szenendaten mit Blender Python auslesen

Mit der Python-API von Blender können Sie auf Szenen- und Objektdaten zugreifen, die auch über die Benutzeroberfläche verfügbar sind. Für einen ersten Test genügt ein kleines Skript, das die Namen der Objekte in der Szene ausgibt:

import bpy

for obj in bpy.data.objects:
    print(obj.name)

Um das Skript in Blender auszuführen, wechseln Sie zum Arbeitsbereich Scripting und erstellen Sie im Texteditor einen neuen Text-Datenblock. Fügen Sie den Code in den Texteditor ein und führen Sie ihn mit Run Script aus. Für kurze Befehle und zum Erkunden der API mit Autovervollständigung eignet sich auch die Python Console.

Dieselbe Skriptdatei lässt sich über die Option --python von der Kommandozeile ausführen:

blender -b sahne.blend --python rapor.py

So können Berichte, die Daten in einer Datei untersuchen, wiederholbar und ohne geöffnete Benutzeroberfläche ausgeführt werden. Für Skripte, die über die Kommandozeile gestartet werden, ist außerdem die Option --python-exit-code dokumentiert. Mit ihr lässt sich bei einem Python-Fehler ein bestimmter Exit-Code festlegen. Das kann dabei helfen, fehlgeschlagene Ausführungen zu erkennen, wenn das Skript Teil eines automatisierten Workflows ist.

Häufige Fehler

• Den Ausgabepfad falsch interpretieren: Der relative Pfad // bezieht sich auf die .blend-Datei. Wenn Sie die Ausgabe an einem anderen Ordner suchen, kann es so wirken, als wäre das Rendering verschwunden.

• Frame-Nummer oder Bereich verwechseln: -f rendert einen einzelnen Frame; -a verarbeitet die Animation zwischen Start- und Endframe der Szene. Prüfen Sie für den gewünschten Bereich die Werte für -s und -e.

• Die Cycles-Option an der falschen Stelle angeben: Cycles-Optionen wie --cycles-device müssen in der Kommandozeile nach dem Trennzeichen -- stehen.

• Ein auf der Hardware nicht verfügbares Gerät auswählen: Die in der Dokumentation aufgeführten Gerätenamen bedeuten nicht, dass jede Installation sie unterstützt. Führen Sie zuerst einen kurzen Test-Render auf dem Zielrechner aus.

• Die Ausgabe eines Python-Skripts an der falschen Stelle suchen: Laut Blender-API-Dokumentation wird die Ausgabe einiger Beispiele im Terminal angezeigt. Wenn das Skript fertig ist, aber nichts zu sehen ist, prüfen Sie das Terminal, über das Blender gestartet wurde.

Auswirkungen auf Architektur- und Visualisierungs-Workflows

Hintergrundrenderings können für Visualisierungsteams nützlich sein, die wiederholte Frames oder Animationen per Befehl starten möchten. Python-Skripte unterstützen außerdem die Analyse von Szenendaten und das Erstellen einfacher Berichte. Diese Vorgehensweise ersetzt weder Modellierungs- noch Entwurfsentscheidungen, sondern standardisiert bestimmte Abläufe in der Produktion.

Prüfen Sie vor dem Start die Blender-Version, die verwendete Render-Engine, das Ausgabeformat und die Unterstützung des Cycles-Geräts auf dem Zielrechner. Kommandozeilenoptionen erleichtern zwar das Starten eines Renderings, garantieren aber nicht, dass die Szene korrekte Ergebnisse liefert. Erst einen einzelnen Frame zu testen, um Pfad, Format und Gerät zu prüfen, und anschließend mit der Animation fortzufahren, ist ein kontrollierteres Vorgehen. Lizenz- oder Kontobedingungen werden in diesen Dokumenten nicht erläutert. Prüfen Sie die Anforderungen für Installation und Nutzung in einer Teamumgebung daher separat.

Nächste Schritte

Nachdem Sie das Beispiel mit einem einzelnen Frame in Ihrer eigenen Datei überprüft haben, können Sie mit der Animationsoption und der Benennung der Ausgabedateien fortfahren. Beginnen Sie auf der Python-Seite mit einem schreibgeschützten Berichtsskript. Das Auflisten von Objektnamen ist ein einfacher Einstieg, um den Zugriff auf die Szene zu überprüfen. Anschließend können Sie anhand der Kommandozeilenoptionen und der API-Referenz die benötigten Aufgaben ergänzen. Die Python-API-Dokumentation weist darauf hin, dass sich der Kontext je nach Bereich unterscheiden kann und manche Operatoren einen gültigen Kontext erfordern. Deshalb ist es wichtig, das Skript mit der Blender-Version und im Szenenkontext zu testen, in dem es ausgeführt werden soll.

Quellen und Lizenz

Als Grundlage dienten die Seiten „Command Line Arguments“ im Blender Manual sowie „Quickstart“ und „API Overview“ der Blender Python API. Alle drei Quellen stehen unter der Lizenz CC BY-SA 4.0; der Inhalt wurde ins Türkische übertragen und neu formuliert. Die Beispielbefehle und das kurze Python-Skript wurden für diesen Leitfaden auf Grundlage der dokumentierten Optionen und API-Nutzung erstellt.