Architektur-Renderings mit Blender 5.2 LTS über die Kommandozeile erstellen

Was lernen Sie in diesem Leitfaden?

Blender muss nicht in jeder Phase der Bildproduktion über die Benutzeroberfläche bedient werden. Mit Kommandozeilenoptionen können Sie eine blend-Datei rendern, ohne die Oberfläche zu öffnen, ein Einzelbild oder eine Animation auswählen und Dateiname sowie Speicherort festlegen. Bei der Arbeit mit Cycles gehören auch die Angabe des Rendergeräts, die Auswahl eines Bildbereichs und das Ausführen eines Python-Skripts zu diesem Workflow.

Diese Methode kann den Workflow übersichtlicher machen, insbesondere wenn mehrere Bilder derselben Szene gerendert oder wiederkehrende Aufgaben automatisiert werden. Die Kommandozeile ersetzt jedoch nicht die Szeneneinstellungen: Die zu rendernde blend-Datei und der Szeneninhalt müssen bereits vorbereitet sein. In diesem Leitfaden geht es nicht um den Szenenaufbau, sondern darum, wie Sie den Renderprozess mit den dokumentierten Kommandozeilenoptionen von Blender starten.

Voraussetzungen

Die Kommandozeilendokumentation von Blender ist unter der Überschrift Blender 5.2 LTS verfügbar. Voraussetzung ist eine vorbereitete blend-Datei mit der gewünschten Szene. In den Quellen wird keine weitere Kontovoraussetzung genannt. Blender muss in der jeweiligen Umgebung über die Kommandozeile gestartet werden können.

Wenn Sie Cycles verwenden, muss Cycles als Render-Engine der Szene eingestellt und ein passendes Gerät ausgewählt sein. In der Dokumentation werden CPU, CUDA, OPTIX, HIP, ONEAPI und METAL als Geräteoptionen aufgeführt. Welche davon verfügbar ist, hängt vom System und der Installation ab. Die Dokumentation garantiert keine Kompatibilität mit bestimmter Hardware. Testen Sie die Option daher in Ihrer Arbeitsumgebung, bevor Sie sie für einen Produktionsauftrag verwenden.

Schritt für Schritt: Rendern über die Kommandozeile

1. Blender ohne Benutzeroberfläche starten

Mit -b oder --background wird Blender ohne Benutzeroberfläche ausgeführt. Die grundlegende Reihenfolge lautet: Blender-Befehl, Optionen, Dateiname und gegebenenfalls weitere Optionen. Ersetzen Sie den Dateinamen durch Ihr eigenes blend-Projekt. Das folgende Beispiel ist der in der Dokumentation gezeigte Befehl zum Rendern einer Animation.

blender -b animation.blend -o //render_ -F PNG -x 1 -a

In diesem Beispiel rendert -a die Animation zwischen Start- und Endbild. Mit -o werden Ausgabepfad und Dateiname festgelegt, mit -F das Format und mit -x, ob die Dateierweiterung angefügt wird. Das Beispiel verwendet PNG und setzt die Option zum Anhängen der Erweiterung auf 1.

2. Ausgabepfad und Bildnummern planen

Ein mit // beginnender Ausgabepfad ist relativ zur blend-Datei. Um die Dateien einer Animation unter einem gemeinsamen Stammnamen zu speichern, können Sie einen Pfad wie //render_ aus dem Beispiel angeben. Werden im Dateinamen #-Zeichen verwendet, werden sie durch die Bildnummer ersetzt. Die Anzahl der Zeichen bestimmt die Länge der mit Nullen aufgefüllten Nummer. In der Dokumentation wird beispielsweise gezeigt, dass animation_##_test.png mit der Bildnummer ergänzt wird. Fehlt # im Dateinamen, fügt Blender am Ende #### hinzu.

Mit -f oder --render-frame wählen Sie die zu rendernden Bilder aus. Neben einer einzelnen Bildnummer können Sie eine durch Kommas getrennte Liste oder einen mit .. angegebenen Bildbereich festlegen; Leerzeichen sind in der Liste nicht zulässig. Mit -s und -e lassen sich Start- und Endbild separat angeben. So können Sie statt der vollständigen Animation einzelne Bilder testen.

3. Ein Einzelbild rendern

Für ein einzelnes Testbild verwenden Sie die Option -f. Das Dokumentationsbeispiel öffnet die Datei im Hintergrund, rendert Bild 20 und gibt das Cycles-Gerät an:

blender -b file.blend -f 20 -- --cycles-device OPTIX

Die zwei Bindestriche zeigen an, dass danach Optionen für das Cycles-Add-on folgen. OPTIX ist das in diesem Beispiel ausgewählte Gerät. Zu den Optionen, die auf anderen Systemen verfügbar sein können, gehören auch CPU, CUDA, HIP, ONEAPI und METAL. Dass ein Gerät in der Liste steht, bedeutet nicht, dass es auf jedem Rechner funktioniert. Ein kurzer Test-Render mit anschließender Überprüfung kann mögliche Probleme aufdecken, bevor Sie eine umfangreiche Animation starten.

4. Die Animation oder ausgewählte Bilder rendern

Mit -a rendern Sie die gesamte Animation, also die Bilder vom Start bis zum Ende. Soll ein anderer Bereich als der in der Szene festgelegte gerendert werden, geben Sie ihn zusätzlich mit -s und -e an. Mit -j lässt sich die Schrittweite zwischen den gerenderten Bildern einstellen. Eine Prüfliste aus ausgewählten Bildern erleichtert es beispielsweise, die Darstellung der Szene zu beurteilen, ohne die gesamte Animation zu rendern.

Wählen Sie das Renderformat mit -F. In der Dokumentation werden unter anderem PNG, JPEG, TIFF, HDR und BMP aufgeführt. Darüber hinaus gibt es weitere Formate, die je nach System und Build verfügbar sein können. Gehen Sie nicht davon aus, dass jedes Format in jeder Installation vorhanden ist. Berücksichtigen Sie bei der Auswahl sowohl die Anforderungen an die Ausgabe als auch die Verfügbarkeit in Ihrer Blender-Installation.

5. Cycles- und Prozessorthread-Optionen prüfen

Geben Sie Optionen für das Cycles-Gerät nach den zwei Bindestrichen an. Die Dokumentation beschreibt auch die gemeinsame Nutzung von CPU und GPU, indem Sie +CPU zum GPU-Gerät hinzufügen. Testen Sie, ob sich das für Ihre Arbeit eignet; die Quellen versprechen keine bestimmte Geschwindigkeit oder Leistung für eine konkrete Szene.

Mit -t oder --threads legen Sie die Anzahl der Threads für das Rendern und andere Vorgänge fest. Der dokumentierte Bereich reicht von 1 bis 1024; bei 0 wird die Anzahl der Prozessoren im System verwendet. Diese Einstellung kann dazu dienen, das Verhalten der Workstation während des Renderns zu steuern. Kommandozeilenoptionen bestätigen allerdings nicht eigenständig die Kompatibilität von Hardware oder Treibern.

6. Ein Python-Skript ausführen

Blender verfügt über einen integrierten Python-Interpreter. Module wie bpy können für den Zugriff auf Blender-Daten verwendet werden. Zum Ausführen einer Python-Datei über die Kommandozeile ist die Option --python dokumentiert:

blender --python /home/me/my_script.py

Damit Skripte mit Blender-Daten arbeiten können, müssen sie die entsprechenden Blender-Module importieren. Beim Aufruf von bpy.ops-Operatoren werden Eigenschaften als Schlüsselwortargumente übergeben; ein Aufruf im falschen Kontext kann einen Fehler verursachen. Die Dokumentation zeigt die Prüfung mit poll() als Möglichkeit, dieses Risiko zu verringern. Die Einstellung für die automatische Ausführung von Python-Skripten ist standardmäßig deaktiviert. Mit -y wird sie aktiviert, mit -Y deaktiviert. Verwechseln Sie die Optionen zum Ausführen von Skripten nicht mit denen zur automatischen Ausführung, sondern wählen Sie die jeweils benötigte Einstellung bewusst aus.

Was ändert sich im Architektur- und Visualisierungsworkflow?

Das Rendern über die Kommandozeile kann für Architekturbüros, Innenarchitekten und Archviz-Künstler nützlich sein, wenn sie wiederholt Bilder aus derselben Datei verarbeiten, Animationen nach einem einheitlichen Benennungsschema ausgeben oder während des Renderns auf eine Benutzeroberfläche verzichten möchten. Auch Studierende können zunächst mit Einzelbildern die Szenen- und Ausgabeeinstellungen überprüfen und anschließend zur Animation übergehen. Ein Ausgabepfad relativ zur blend-Datei hilft dabei, die Beziehung zwischen Projektdatei und Ausgaben übersichtlich zu halten.

Zu beachten sind insbesondere Hardware, Kompatibilität und Dateiorganisation. Wählen Sie für Cycles nur ein Gerät, das auf dem System tatsächlich verfügbar ist, und prüfen Sie das Ergebnis mit einem begrenzten Render, bevor Sie einen Auftrag mit vielen Bildern starten. In Projekten mit mehreren Beteiligten sollten Dateiname, Bildbereich, Format und Ausgabepfad eindeutig festgelegt sein. Die Quellen enthalten keine Angaben zu Lizenz oder Kosten; dieser Leitfaden beschreibt die Verwendung der Kommandozeile und die Bedeutung der Optionen.

Häufige Fehler

• Die Cycles-Option an der falschen Stelle eintragen: Die Option --cycles-device muss nach den zwei Bindestrichen stehen. Halten Sie sich an die gezeigte Befehlsstruktur.

• Den Speicherort der Ausgabe offenlassen: Legen Sie Pfad und Dateinamensstamm mit -o fest. Bei Verwendung von // ist der Pfad relativ zur blend-Datei.

• Das Format der Bildnummerierung übersehen: #-Zeichen beeinflussen die Nummerierung und die Auffüllung mit Nullen. Prüfen Sie den Dateinamen im Voraus.

• Direkt eine lange Animation starten: Testen Sie zunächst ein Einzelbild oder ausgewählte Bilder und überprüfen Sie Format und Ausgabepfad.

• Einen Operator aufrufen, ohne den Kontext zu prüfen: In einem Python-Skript hilft poll() dabei, vorab zu prüfen, in welchem Kontext ein Operator ausgeführt werden kann.

Nächste Schritte

Erstellen Sie zunächst einen Befehl für ein einzelnes Testbild und überprüfen Sie anschließend Ausgabepfad und Format. Wird das Ergebnis wie erwartet am richtigen Ort und unter dem gewünschten Namen erstellt, können Sie denselben Aufbau für das Rendern einer Animation verwenden. Beginnen Sie bei Python-Skripten mit einem kleinen Vorgang und prüfen Sie bei Operatoraufrufen den erforderlichen Kontext sowie das Ergebnis von poll(). Verifizieren Sie die benötigten Optionen anhand der Blender-Dokumentation zur Kommandozeile und API. Testen Sie das Verhalten in der verwendeten Version und auf Ihrem System, ohne über die in den Quellen aufgeführten Optionen hinauszugehen.

Quellen und Lizenz

Dieser Leitfaden wurde anhand der offiziellen Dokumentation von Blender zu Kommandozeilenargumenten, bpy.ops-Operatoren und der Python-API ins Türkische übertragen. Alle drei Quellen stehen unter der Lizenz CC BY-SA 4.0. Die Befehlsbeispiele und technischen Erläuterungen beruhen auf den Informationen in diesen offen lizenzierten Dokumenten.