P09: PRINCIPLED BSDF SETUP

ID: P09 | Cluster: Materials PBR | PROMPT: ⭐ | Tags: #materials #pbr #principled-bshf #shader-nodes

---

🎯 ZIEL

Principled BSDF Material mit komplettem PBR-Mapset erstellen und einrichten

---

📝 PROMPT

Erstelle Material "[MAT_NAME]" vom Typ Principled BSDF:
Base Color: [R, G, B] oder hex #RRGGBB
Roughness: [0.0-1.0]
Metallic: [0.0-1.0]
[Optional] Transmission, IOR, Clearcoat, Sheen, Emission
Weise es dem Objekt "[OBJECT_NAME]" zu

---

🔧 MCP: set_material (Basis)

{
  "type": "set_material",
  "params": {
    "object_name": "Cube",
    "material_name": "Mat_Red",
    "color": [1.0, 0.0, 0.0, 1.0]
  }
}

---

🔧 MCP: execute_blender_code (volles PBR)

import bpy
from pathlib import Path

def create_pbr_material(name, maps_dict, obj_name=None):
    """
    maps_dict keys: 'base_color', 'roughness', 'metallic', 'normal', 'height', 'ao', 'emission'
    values: filepath oder Color-Tupel (R,G,B,A)
    """
    mat = bpy.data.materials.new(name)
    mat.use_nodes = True
    nodes = mat.node_tree.nodes
    links = mat.node_tree.links
    nodes.clear()

    # Principled BSDF
    principled = nodes.new('ShaderNodeBsdfPrincipled')
    principled.location = (0, 0)

    # Material Output
    output = nodes.new('ShaderNodeOutputMaterial')
    output.location = (400, 0)
    links.new(principled.outputs['BSDF'], output.inputs['Surface'])

    # Displacement
    disp = nodes.new('ShaderNodeDisplacement')
    disp.location = (200, -200)
    links.new(disp.outputs['Displacement'], output.inputs['Displacement'])
    mat.displacement_method = 'BOTH'

    # Texture Coordinate + Mapping
    tex_coord = nodes.new('ShaderNodeTexCoord')
    tex_coord.location = (-600, 0)
    mapping = nodes.new('ShaderNodeMapping')
    mapping.location = (-400, 0)
    links.new(tex_coord.outputs['UV'], mapping.inputs['Vector'])

    def add_texture(key, input_name, colorspace='sRGB', use_normal_map=False, use_disp=False):
        if key not in maps_dict:
            return
        val = maps_dict[key]

        if isinstance(val, (tuple, list)):  # Farbe
            principled.inputs[input_name].default_value = val + (1.0,) if len(val)==3 else val
            return

        # Bilddatei
        tex = nodes.new('ShaderNodeTexImage')
        tex.image = bpy.data.images.load(str(val))
        tex.image.colorspace_settings.name = colorspace
        tex.location = (-200, 0)
        links.new(mapping.outputs['Vector'], tex.inputs['Vector'])

        if use_normal_map:
            nmap = nodes.new('ShaderNodeNormalMap')
            nmap.location = (0, -100)
            links.new(tex.outputs['Color'], nmap.inputs['Color'])
            links.new(nmap.outputs['Normal'], principled.inputs[input_name])
        elif use_disp:
            links.new(tex.outputs['Color'], disp.inputs['Height'])
        else:
            links.new(tex.outputs['Color'], principled.inputs[input_name])

    # Maps verbinden
    add_texture('base_color', 'Base Color', 'sRGB')
    add_texture('roughness', 'Roughness', 'Non-Color')
    add_texture('metallic', 'Metallic', 'Non-Color')
    add_texture('normal', 'Normal', 'Non-Color', use_normal_map=True)
    add_texture('height', 'Height', 'Non-Color', use_disp=True)
    add_texture('emission', 'Emission Color', 'sRGB')

    # AO -> Mix mit Base Color
    if 'ao' in maps_dict:
        ao_tex = nodes.new('ShaderNodeTexImage')
        ao_tex.image = bpy.data.images.load(str(maps_dict['ao']))
        ao_tex.image.colorspace_settings.name = 'Non-Color'
        ao_tex.location = (-200, 200)
        links.new(mapping.outputs['Vector'], ao_tex.inputs['Vector'])

        mix = nodes.new('ShaderNodeMixRGB')
        mix.blend_type = 'MULTIPLY'
        mix.location = (0, 100)
        # Base Color via Mix neu verbinden
        if principled.inputs['Base Color'].links:
            from_node = principled.inputs['Base Color'].links[0].from_node
            from_socket = principled.inputs['Base Color'].links[0].from_socket
            links.new(from_socket, mix.inputs[1])
        links.new(ao_tex.outputs['Color'], mix.inputs[2])
        links.new(mix.outputs['Color'], principled.inputs['Base Color'])

    # Objekt zuweisen
    if obj_name:
        obj = bpy.data.objects.get(obj_name)
        if obj:
            if obj.data.materials:
                obj.data.materials[0] = mat
            else:
                obj.data.materials.append(mat)

    return mat

# === VERWENDUNGSBEISPIELE ===

# 1. Einfache Farbe
create_pbr_material("Mat_Red", {
    'base_color': (1.0, 0.2, 0.2, 1.0),
    'roughness': 0.5,
    'metallic': 0.0
}, "Cube")

# 2. Gold
create_pbr_material("Mat_Gold", {
    'base_color': (1.0, 0.843, 0.0, 1.0),
    'roughness': 0.1,
    'metallic': 1.0
}, "Ring")

# 3. Glas
create_pbr_material("Mat_Glass", {
    'base_color': (1.0, 1.0, 1.0, 1.0),
    'roughness': 0.0,
    'transmission': 1.0,  # bei Bedarf in Funktion ergänzen
    'ior': 1.45
}, "Glass_Obj")

# 4. Voll-PBR aus Dateien
create_pbr_material("Mat_Brick", {
    'base_color': Path("//textures/brick_basecolor.png"),
    'roughness': Path("//textures/brick_roughness.png"),
    'normal': Path("//textures/brick_normal.png"),
    'height': Path("//textures/brick_height.png"),
    'ao': Path("//textures/brick_ao.png"),
}, "Wall")

---

📊 PBR-PARAMETER-SPICKZETTEL

Material	Base Color	Roughness	Metallic	Transmission	IOR	Clearcoat
Plastik	Farbe	0.3-0.5	0.0	0.0	1.5	0.0
Metall (poliert)	Metallfarbe	0.05-0.15	1.0	0.0	—	0.0
Metall (rostig/matt)	Metallfarbe	0.6-0.9	1.0	0.0	—	0.0
Glas	Weiß	0.0	0.0	1.0	1.45-1.5	0.0
Wasser	Hellblau	0.05	0.0	1.0	1.33	0.0
Haut	Hautfarbe	0.6-0.8	0.0	0.0	1.5	0.1-0.3
Stoff	Stofffarbe	0.8-1.0	0.0	0.0	1.5	0.0
Keramik	Farbe	0.1-0.3	0.0	0.0	1.5	0.2-0.5
Stein/Beton	Grau/beige	0.7-1.0	0.0	0.0	1.5	0.0
Holz	Holzton	0.6-0.9	0.0	0.0	1.5	0.0

---

🎨 SPEZIALEFFEKTE

Emission (Glühen)

principled.inputs['Emission Color'].default_value = (1.0, 0.8, 0.2, 1.0)  # Warmes Licht
principled.inputs['Emission Strength'].default_value = 5.0  # Stärke

Clearcoat (Lack/Keramik)

principled.inputs['Coat Weight'].default_value = 1.0
principled.inputs['Coat Roughness'].default_value = 0.03

Sheen (Stoff/Samt)

principled.inputs['Sheen Weight'].default_value = 0.5
principled.inputs['Sheen Roughness'].default_value = 0.3
principled.inputs['Sheen Tint'].default_value = 0.5

Subsurface (Haut, Wachs, Marmor)

principled.inputs['Subsurface Weight'].default_value = 0.3
principled.inputs['Subsurface Radius'].default_value = (1.0, 0.2, 0.1)  # RGB-Eindringradius
principled.inputs['Subsurface Color'].default_value = (1.0, 0.3, 0.1, 1.0)

Anisotropic (gerillte Oberflächen)

principled.inputs['Anisotropic'].default_value = 0.8
principled.inputs['Anisotropic Rotation'].default_value = 0.25  # 90°
# Tangent-Eingang nötig (UV oder Geometry > Tangent)

---

🔗 СВЯЗИ

• Fälle: Case 01: ArchViz, Case 03: Product Viz
• Workflows: WF 03: Texture Pipeline
• Prompts: P10 Node Groups, P11 Procedural Textures
• MCP Tool: set_material (Basis), execute_blender_code (voll)
• Nächster: P10: Node Group Creation