Neueste Meldungen
USD-Szenen in Houdini Solaris aufbauen: Leitfaden zum Layer-WorkflowGPT-6 Astra trägt zum Beweis eines Problems der Teilchenphysik beiUnreal Engine Level Streaming: So verwalten Sie große ArchitekturszenenNVIDIA Vera vorgestellt: HPC-Plattform mit 192 CPUs für wissenschaftliche SimulationenBlender-Mesh bereinigen: Leitfaden zu Voxel Remesh und RetopologieAmbasz–MoMA-Preis für das Friendship Centre: Architektur im Einklang mit der NaturBlender Python: Szene, Kamera und Render-Einstellungen steuernSzenen mit Datasmith in Unreal Engine importieren: ArchitekturvisualisierungUV-Mapping in Blender: Saubere UV-Maps mit NähtenNVIDIA meldet MLPerf-Spitzenleistungen für Vera Rubin
TutorialsBlenderBlender Project Setup

Blender Python: Szene, Kamera und Render-Einstellungen steuern

Mit der Blender Python API lassen sich zahlreiche Einstellungen steuern – vom Zeitbereich der Szene über die aktive Kamera bis zur Renderauflösung. Dieser Leitfaden erläutert die wichtigsten Funktionen für Architekturvisualisierungen anhand von Beispielen.

Kamera und architektonische Details in einem lichtdurchfluteten Innenraum, dessen Bildausschnitt überprüft wirdKI-Bild
Symbolbild, mit KI erzeugt.Bild: 3dsınıfı / FCA AI

Kurz gesagt

  1. Szenenbereich, aktueller Frame und Simulationsbereich lassen sich über Scene-Eigenschaften anpassen.
  2. Aktive Kamera, Objektivwert und Kompositionshilfen gehören zu den Camera-Eigenschaften.
  3. Renderauflösung, Bildrate und Ausgabeverhalten lassen sich über RenderSettings konfigurieren.
  4. 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.

python
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1

Der 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.

python
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120

Eine Ä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.

python
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0

In 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.

python
camera.show_composition_thirds = True

Bei 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.

python
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24

Fü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 Quellen
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Scene.html
Zusammenfassung
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.RenderSettings.html
Zusammenfassung
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Camera.html
Zusammenfassung

Quelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.

Die Einschätzung von 3dsınıfı
3dEinschätzung der Redaktion

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.

Kommentare und Forum sind auf Türkisch.Mitdiskutieren
+

Verwandte Meldungen