Materialeinstellungen in Architekturszenen mit Blender Python: in 5 Schritten

In diesem Leitfaden erfahren Sie, wie Sie mit der Python API von Blender auf das aktive Material eines Objekts in der Szene zugreifen und grundlegende Einstellungen für dessen Erscheinungsbild ändern. Die aktuelle API-Dokumentation von Blender beschreibt Eigenschaften wie Roughness, metallische Reflexion, Farbe, Transparenzmethode und den Umgang mit Displacement. Die Beispiele können als Ausgangspunkt dienen, wenn Sie Oberflächen wie Wände, Holz, Metall und Glas in Architekturvisualisierungen bearbeiten. Der Code arbeitet mit einer vorhandenen Szene und einem vorhandenen Material; das Erstellen eines Materials von Grund auf oder der Aufbau eines nodebasierten Materials ist nicht enthalten.

Was Sie in diesem Tutorial lernen

Zunächst erfahren Sie, wie Sie das Material des aktiven Objekts über Python prüfen. Anschließend passen Sie Farbe, Roughness und Metallic-Wert an und sehen, was die Optionen für Transparenz und Displacement bedeuten und welche Einschränkungen zu beachten sind.

Dieser Ansatz kann besonders bei wiederkehrenden Szenenbearbeitungen oder für Anwender hilfreich sein, die Materialwerte per Code ändern möchten. Das Ändern von API-Eigenschaften allein garantiert jedoch kein bestimmtes visuelles Ergebnis. Die Quelldokumentation enthält weder den vollständigen Node-Aufbau eines Materials noch eine fertige Shader-Konfiguration für eine bestimmte architektonische Oberfläche. Betrachten Sie die Codebeispiele daher als kleine Arbeitsschritte, die Einstellungen eines vorhandenen Materials verändern.

Voraussetzungen

• In Blender muss eine Szene geöffnet und ein Objekt aktiv sein.

• Dem aktiven Objekt muss ein Material zugewiesen sein. Wenn kein aktives Material vorhanden ist, nimmt der Code keine Änderungen vor.

• Über bpy.context.view_layer.objects.active lässt sich in der Blender Python API auf das aktive Objekt zugreifen; dessen Eigenschaft active_material liefert das aktive Material.

• Für diese Beispiele werden weder ein Konto noch ein Abonnement oder ein separates Add-on vorausgesetzt. Die Quelle ist die aktuelle API-Dokumentation von Blender; eine Installationsanleitung für eine bestimmte Blender-Version wird nicht angegeben.

In der Dokumentation steht, dass die Eigenschaft use_nodes ab Version 5.0 veraltet ist und voraussichtlich in Version 6.0 entfernt wird. Da dieses Tutorial nicht auf dieser Eigenschaft beruht, kommt use_nodes in den Codebeispielen nicht vor. Außerdem wird darauf hingewiesen, dass für die Transparenzmethode anstelle der alten Eigenschaft blend_method die Eigenschaft surface_render_method verwendet werden soll.

Materialeinstellungen Schritt für Schritt

1. Material des aktiven Objekts prüfen

Im ersten Schritt rufen Sie das aktive Objekt in Blender ab und prüfen, ob ihm ein aktives Material zugewiesen ist. Führen Sie den folgenden Code im Kontext der Blender Python API aus:

obj = bpy.context.view_layer.objects.active
material = obj.active_material if obj else None

if material is not None:
    print(material.name)

Wenn ein aktives Objekt vorhanden ist, weist der Code dessen aktives Material der Variablen zu. Ist ein Material vorhanden, wird sein Name ausgegeben. So können Sie überprüfen, welches Material Sie in den folgenden Schritten bearbeiten. Wenn weder ein aktives Objekt noch ein Material vorhanden ist, fährt der Code nicht mit der Bearbeitung von Eigenschaften fort.

2. Farbe, Roughness und Metallic-Wert anpassen

Der Material-Datenblock enthält die Eigenschaften diffuse_color, roughness und metallic. In der Dokumentation wird diffuse_color als Farbwert mit vier Komponenten beschrieben; für roughness und metallic gilt jeweils der Wertebereich von 0 bis 1. Das folgende Beispiel weist diesen Feldern Werte über die Variable material aus dem vorherigen Schritt zu:

if material is not None:
    material.diffuse_color = (0.55, 0.35, 0.20, 1.0)
    material.roughness = 0.6
    material.metallic = 0.0

Diese Werte dienen als Beispiele für Zuweisungen an die entsprechenden API-Felder. Sie sind nicht zwangsläufig die korrekten physikalischen Werte für eine bestimmte Holz-, Lack- oder Metalloberfläche. Prüfen Sie das Erscheinungsbild des Materials in der Architekturvisualisierung immer im Zusammenspiel mit der Beleuchtung der Szene und dem verwendeten Materialaufbau. Die Quelldokumentation sagt nicht aus, dass diese Werte für sich genommen einer Messung einer realen Oberfläche entsprechen.

3. Transparenzmethode festlegen

In der aktuellen Dokumentation werden für die Eigenschaft surface_render_method zwei Optionen aufgeführt: DITHERED und BLENDED. DITHERED ermöglicht Transparenz über einen Graustufen-Hash und wird als kompatibel mit Render-Passes und Raytracing-Funktionen beschrieben. BLENDED bietet farbige Transparenz, ist jedoch nicht mit Render-Passes und Raytracing kompatibel.

if material is not None:
    material.surface_render_method = 'DITHERED'

Diese Einstellung bestimmt die Methode für das Mischen der Transparenz. Gehen Sie nicht davon aus, dass damit allein bereits eine Glasoptik entsteht. Die Quelle erklärt weder alle erforderlichen Shader-Nodes für Transparenz noch die Einrichtung von Alpha-Werten. Außerdem ist die alte Eigenschaft blend_method als veraltet gekennzeichnet. Verwenden Sie in einem neuen Skript vorzugsweise das in der aktuellen Dokumentation aufgeführte Feld surface_render_method.

4. Displacement-Methode festlegen

In der Materialdokumentation werden für displacement_method die Optionen BUMP, DISPLACEMENT und BOTH aufgeführt. BUMP simuliert den Displacement-Eindruck mithilfe von Bump Mapping. DISPLACEMENT verwendet ausschließlich echtes Displacement der Oberfläche und erfordert eine feine Unterteilung. BOTH kombiniert echtes Displacement mit dem Bump-Ansatz.

if material is not None:
    material.displacement_method = 'BUMP'

Dieses Beispiel ist eine Ausgangseinstellung für Fälle, in denen keine echte geometrische Detailtiefe erforderlich ist. Wenn Sie echtes Displacement ausprobieren möchten, beachten Sie die in der Dokumentation genannte Voraussetzung einer feinen Unterteilung. Die Quelle gibt keine konkrete Anzahl an Unterteilungen vor. Testen Sie die Einstellung daher kontrolliert mit Ihrer Szene und Geometrie, statt einen bestimmten Wert anzunehmen.

5. Änderungen gemeinsam anwenden

Wenn Sie mehrere Einstellungen innerhalb derselben Bedingung ändern, bleibt die Prüfung auf ein aktives Material an einer Stelle. Das folgende Beispiel fasst die Felder aus den vorherigen Schritten zusammen:

if material is not None:
    material.roughness = 0.45
    material.metallic = 0.0
    material.surface_render_method = 'DITHERED'
    material.displacement_method = 'BUMP'

Die Zahlenwerte sind Beispiele und keine universelle Vorgabe für jede Szene. Prüfen Sie in Ihrer Datei nach jeder Änderung das Renderergebnis und den bestehenden Materialaufbau. Die Anwendung auf mehrere Materialien, das Erstellen von Materialien und die Bearbeitung des Node-Trees sind nicht Bestandteil dieses Leitfadens.

Häufige Fehler

Ein häufiger Fehler ist die Annahme, dass das aktive Objekt zwangsläufig ein Material hat. Deshalb enthält der Code eine Prüfung auf None. Ein weiterer Fehler besteht darin, BLENDED grundsätzlich als die bessere Transparenzmethode anzusehen: Laut Dokumentation ist diese Methode nicht mit Render-Passes und Raytracing kompatibel. Ein dritter Fehler ist, DISPLACEMENT auszuwählen und dabei zu übersehen, dass die Geometrie ausreichend unterteilt sein muss.

Verlassen Sie sich in neuem Code außerdem nicht auf veraltete Felder wie blend_method. Verwenden Sie auch die Eigenschaft use_nodes nicht als einfachen Ein-/Ausschalter für einen aktuellen Material-Workflow. Laut Dokumentation ist dieses Feld seit Version 5.0 veraltet, soll in Version 6.0 entfernt werden und hat keine Wirkung, wenn es gesetzt wird. Da dieses Tutorial nicht erklärt, wie der Node-Tree aufgebaut wird, enthält es keinen Code, der ihn verändert.

Auswirkungen auf Architektur- und Visualisierungs-Workflows

Diese Methode richtet sich an Architektinnen und Architekten, Innenarchitektinnen und Innenarchitekten sowie Visualisierungsprofis, die grundlegende Eigenschaften des aktiven Materials in einer Szene per Code ändern möchten. Sie bietet einen praktischen Einstieg, um Roughness- oder Metallic-Werte innerhalb eines Projekts einheitlich anzupassen. Die Quellen garantieren jedoch weder Leistungssteigerungen noch bestimmte Hardwareanforderungen oder Kompatibilität zwischen Render-Engines. Berücksichtigen Sie bei der Transparenzmethode insbesondere die Kompatibilität mit Render-Passes und Raytracing und bei echtem Displacement die Geometriedichte.

Nächste Schritte

Arbeiten Sie zunächst mit dem aktiven Material eines einzelnen Objekts und prüfen Sie das Ergebnis nach jeder Änderung. Testen Sie den Ansatz anschließend in Ihrer eigentlichen Projektdatei mit der verwendeten Szene und den Render-Einstellungen. Für weitergehende Automatisierungen können Sie die Abschnitte Material und Object in der Blender API-Dokumentation gemeinsam heranziehen. Diese Quellen beschreiben die vorhandenen Materialeigenschaften und den Zugriff eines Objekts auf das aktive Material. Überprüfen Sie vor dem Einsatz eines neuen Skripts in der Produktion außerdem das API-Verhalten in der von Ihnen verwendeten Blender-Version.

Quelle und Lizenz

Dieses Tutorial basiert auf den Beschreibungen der Eigenschaften in der Blender-API-Dokumentation zu Material und Object. Beide Quellen stehen unter der Lizenz CC BY-SA 4.0. Die Inhalte wurden ins Türkische übertragen und die Codebeispiele für die Bearbeitung von Architekturmaterialien neu formuliert.