Kurz gesagt
- Szenenbereich, aktueller Frame und Simulationsbereich lassen sich über Scene-Eigenschaften anpassen.
- Aktive Kamera, Objektivwert und Kompositionshilfen gehören zu den Camera-Eigenschaften.
- Renderauflösung, Bildrate und Ausgabeverhalten lassen sich über RenderSettings konfigurieren.
- Einige ältere Compositing-Eigenschaften sind in der aktuellen API-Dokumentation als veraltet gekennzeichnet.
Was Sie in diesem Leitfaden lernen
Mit der Blender Python API lassen sich Daten wie der Zeitbereich einer Szene und die aktive Kamera per Code bearbeiten. Auch die Render-Einstellungen können über die Renderdaten derselben Szene gesteuert werden. In diesem Leitfaden behandeln wir grundlegende Einstellungen, die sich für Architekturvisualisierungen und Innenraumpräsentationen wiederverwenden lassen: Szenen- und Simulationsframes, Kameraobjektiv und Bildausschnitt-Hilfen, Ausgabeauflösung und Bildrate.
Die Beispiele gehen davon aus, dass ein vorhandener Scene-Datenblock in der Variablen scene und ein vorhandener Camera-Datenblock in der Variablen camera verfügbar ist. Die Codeausschnitte sind Zuweisungen zu den angegebenen Eigenschaften und kein Setup-Skript, das die Variablen bereitstellt. Die API-Dokumentation erläutert die Eigenschaftsnamen und zulässigen Wertebereiche. Änderungen zunächst an einer Kopie der Projektdatei auszuprobieren, erleichtert es, die Auswirkungen ungeeigneter Einstellungen für eine Szene zu vergleichen.
Voraussetzungen
Benötigt werden Blender sowie die in der Python-API-Dokumentation beschriebenen Eigenschaften von Scene, RenderSettings und Camera. Die Quellen nennen keine bestimmte Blender-Version, keinen Kontotyp und keine Kostenbedingungen. Die Codebeispiele müssen in einem Python-Kontext ausgeführt werden, in dem Referenzen auf Scene und Camera verfügbar sind. Dieser Leitfaden setzt keinen undokumentierten Menüpfad oder Installationsschritt voraus, um diese Referenzen abzurufen.
Die einzelnen Einstellungen erfüllen unterschiedliche Zwecke. Scene-Eigenschaften definieren den Framebereich und die aktive Kamera einer Szene, während RenderSettings die Ausgabe und das Renderverhalten steuern. Kameraeigenschaften speichern dagegen Kameradaten wie Objektiv und Bildausschnitt-Hilfen. Wer zuerst festlegt, welcher Datenblock geändert werden soll, verringert das Risiko, die falsche Eigenschaft anzupassen.
Schritt 1: Framebereich der Szene anpassen
Im Scene-Datenblock legen frame_start und frame_end den Anfang und das Ende des Wiedergabe- und Renderbereichs fest. frame_current gibt den aktuellen Frame an. Für Animationen oder schrittweise Architekturpräsentationen macht es die Zeitsteuerung der Szene im Skript nachvollziehbar, diese Werte ausdrücklich festzulegen.
Im folgenden Beispiel wird der Szenenbereich auf die Frames 1 bis 120 gesetzt. Diese Werte sind Beispielwerte innerhalb des in der Dokumentation angegebenen zulässigen Bereichs und keine für ein bestimmtes Projekt vorgeschriebene Frameanzahl.
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1Der Zeitbereich von Simulationen kann unabhängig vom allgemeinen Szenenbereich festgelegt werden. simulation_frame_start und simulation_frame_end geben den Anfangs- und Endframe der Simulation an. Mit use_custom_simulation_range wird gesteuert, ob ein vom Szenenbereich abweichender Simulationsbereich verwendet wird. Diese Option ist wichtig, wenn Szenen- und Simulationsbereiche mit unterschiedlicher Dauer voneinander getrennt werden müssen.
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120Eine Änderung dieser Werte garantiert für sich genommen kein bestimmtes visuelles Simulationsergebnis. Zu berücksichtigen ist auch, ob Simulationsknoten im Projekt ihren eigenen Framebereich überschreiben. Laut API-Beschreibung wird der benutzerdefinierte Bereich verwendet, wenn solche Knoten ihren Bereich nicht selbst ändern.
Schritt 2: Aktive Kamera und Bildkomposition steuern
Die Eigenschaft camera der Szene enthält die aktive Kamera, die fürs Rendern verwendet wird. lens im Kamera-Datenblock legt die Brennweite einer perspektivischen Kamera in Millimetern fest. Über lens_unit lässt sich wählen, ob die Brennweite in der Benutzeroberfläche in Millimetern oder über den Sichtwinkel bearbeitet wird. Das folgende Beispiel setzt voraus, dass die Kameradaten bereits in einer Variablen verfügbar sind.
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0In der Kameraansicht lassen sich Kompositionshilfen einblenden. Die Drittelregel wird beispielsweise über show_composition_thirds und der Goldene Schnitt über show_composition_golden ein- und ausgeschaltet. Diese Hilfen unterstützen bei der Beurteilung des Bildausschnitts; sie verändern weder die Szenengeometrie noch automatisch die Kameraposition.
camera.show_composition_thirds = TrueBei der Beurteilung des Bildausschnitts in architektonischen Innenräumen sollten Bildformat und Kamerasichtfeld gemeinsam betrachtet werden. Die Camera API bietet auch Eigenschaften für den horizontalen und vertikalen Sichtwinkel. Außerdem stehen Optionen wie der orthografische Maßstab und Panoramatypen zur Verfügung. Da sie jedoch mit anderen Kameratypen und Anwendungszwecken verbunden sind, sollten sie nicht als Standardeinstellungen für eine perspektivische Innenraumkamera betrachtet werden.
Schritt 3: Renderausgabe und leistungsbezogene Einstellungen anpassen
RenderSettings enthält die horizontale und vertikale Auflösung sowie den Auflösungsprozentsatz. Die Bildrate wird über die Eigenschaft fps festgelegt. Das folgende Beispiel weist die in der Dokumentation genannten Standardwerte für Auflösung und Bildrate ausdrücklich zu. Weichen die gewünschte Bildgröße oder Animationseinstellungen für die Projektabgabe davon ab, sollten die Werte entsprechend angepasst werden.
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24Für eine schnellere Vorschau kann resolution_percentage verringert werden; vor der finalen Ausgabe sollte der Wert jedoch erneut überprüft werden. Die Dokumentation definiert diese Eigenschaft als Prozentsatz der Renderauflösung. Für die Nutzung eines Renderbereichs gibt es use_border und die Begrenzungskoordinaten; use_crop_to_border steuert, ob die Ausgabe auf den definierten Bereich zugeschnitten wird.
Auch das Compositing sollte im Render-Workflow überprüft werden. use_compositing in RenderSettings steuert, ob das Renderergebnis durch eine der Szene zugewiesene Compositor-Node-Gruppe geleitet wird. Laut Dokumentation hat die ältere Eigenschaft Scene.use_nodes keine Wirkung mehr. Zum Aktivieren oder Deaktivieren des Compositings soll scene.render.use_compositing verwendet werden. Die Eigenschaft compositing_node_group ist außerdem ab Version 5.0 als veraltet gekennzeichnet; die Dokumentation nennt Version 6.0 als geplante Version für ihre Entfernung. Daher sollten Eigenschaftsnamen in älteren Skripten mit der aktuellen API-Dokumentation abgeglichen werden.
Häufige Fehler und nächste Schritte
Ein häufiges Problem ist die Annahme, Szenen- und Simulationsbereich seien dieselbe Einstellung. Ein weiteres ist, die Eigenschaften eines anderen Kamera-Datenblocks statt der aktiven Kamera zu ändern. Auch Auflösungsprozentsatz, Abmessungen und Bildrate sollten vor der finalen Ausgabe gemeinsam überprüft werden. use_persistent_data kann Daten für schnellere erneute Renderings und Animationsrenderings im Arbeitsspeicher halten; laut API-Beschreibung steigt dadurch jedoch der Speicherbedarf.
Probieren Sie als nächsten Schritt jede Einstellungsgruppe in einem separaten Skriptabschnitt aus: zuerst den Framebereich, danach den Kamerabildausschnitt und zuletzt die Ausgabeeinstellungen. Erstellen Sie nach jeder Änderung eine kurze Vorschau und vergleichen Sie die Ergebnisse. Müssen dieselben Werte in mehreren Projekten verwendet werden, kann es die Wiederholbarkeit verbessern, die Zuweisungen in einem einzigen, klar strukturierten Skriptablauf zusammenzufassen. Achten Sie dennoch darauf, dass die Referenzen auf die aktive Szene und Kamera korrekt sind. Selbst wenn in den Render-Einstellungen eine GPU-Option angezeigt wird, versprechen die Quellen weder eine bestimmte Hardwarekompatibilität noch ein bestimmtes Leistungsergebnis. Das muss auf dem vorhandenen System getestet werden.
Quellen und Lizenz
Dieser Leitfaden wurde anhand der Erläuterungen zu Scene, RenderSettings und Camera in der Blender API-Dokumentation übersetzt und angepasst. Die Quelldokumentation steht unter der Lizenz CC BY-SA 4.0: die Blender-API-Seiten zu Scene, RenderSettings und Camera.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für Architekturbüros und Visualisierungsteams in der Türkei liegt der praktische Nutzen dieser Funktionen darin, häufig wiederkehrende Szenen- und Ausgabeeinstellungen konsistenter gestalten zu können. Besonders die Steuerung von Animationsbereich, Auflösung und Kamerabildausschnitt per Skript kann es erleichtern, Einstellungen bei der Projektübergabe nachzuvollziehen.
Die Nutzung der API allein verkürzt jedoch nicht die Renderzeit. Dauerhaft gespeicherte Renderdaten können den Speicherbedarf erhöhen, und der Nutzen der GPU-Option hängt vom vorhandenen System ab. Büros sollten Skripte mit ihrer eigenen Szenenstruktur testen und die frühere Verwendung von `use_nodes` mit den aktuellen Eigenschaften vergleichen. Da die Quellen weder Produktpreise noch Hardwarekompatibilität nennen, reicht dieser Leitfaden allein nicht als Grundlage für eine Kauf- oder Leistungsentscheidung aus.
Häufige Fragen
Wie lässt sich der Framebereich einer Szene mit der Blender Python API ändern?
Die Eigenschaften `frame_start` und `frame_end` im Scene-Datenblock legen Anfangs- und Endframe fest. Der aktuelle Frame lässt sich mit `frame_current` einstellen.
Lässt sich die Renderauflösung in Blender mit Python einstellen?
Ja. Die Eigenschaften `resolution_x`, `resolution_y` und `resolution_percentage` in RenderSettings steuern die Auflösung und deren Skalierung.
Sollte `Scene.use_nodes` in der Blender API verwendet werden?
Laut aktueller API-Dokumentation ist diese Eigenschaft ab 5.0 als veraltet gekennzeichnet und eine Änderung bleibt wirkungslos. Zum Steuern des Compositings wird die Eigenschaft `scene.render.use_compositing` genannt.



