P09: CONFIGURACIÓN PRINCIPLED BSDF

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

---

🎯 OBJETIVO

Crear y configurar un material Principled BSDF con el set PBR completo

---

📝 PROMPT

Crea el material "[MAT_NAME]" tipo Principled BSDF:
Base Color: [R, G, B] o hex #RRGGBB
Roughness: [0.0-1.0]
Metallic: [0.0-1.0]
[Opcional] Transmission, IOR, Clearcoat, Sheen, Emission
Asígnaselo al objeto "[OBJECT_NAME]"

---

🔧 MCP: set_material (básico)

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

---

🔧 MCP: execute_blender_code (PBR completo)

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 o tupla Color (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)):  # Color
            principled.inputs[input_name].default_value = val + (1.0,) if len(val)==3 else val
            return

        # Archivo de imagen
        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])

    # Conectar mapas
    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 con 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)
        # Reconectar Base Color vía Mix
        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'])

    # Asignar al objeto
    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

# === EJEMPLOS DE USO ===

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

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

# 3. Cristal
create_pbr_material("Mat_Glass", {
    'base_color': (1.0, 1.0, 1.0, 1.0),
    'roughness': 0.0,
    'transmission': 1.0,  # añadir a la función si se necesita
    'ior': 1.45
}, "Glass_Obj")

# 4. PBR completo desde archivos
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")

---

📊 CHULETA DE PARÁMETROS PBR

Material	Base Color	Roughness	Metallic	Transmission	IOR	Clearcoat
Plástico	Color	0.3-0.5	0.0	0.0	1.5	0.0
Metal (pulido)	Color del metal	0.05-0.15	1.0	0.0	—	0.0
Metal (oxidado/mate)	Color del metal	0.6-0.9	1.0	0.0	—	0.0
Cristal	Blanco	0.0	0.0	1.0	1.45-1.5	0.0
Agua	Azul claro	0.05	0.0	1.0	1.33	0.0
Piel	Color piel	0.6-0.8	0.0	0.0	1.5	0.1-0.3
Tela	Color tela	0.8-1.0	0.0	0.0	1.5	0.0
Cerámica	Color	0.1-0.3	0.0	0.0	1.5	0.2-0.5
Piedra/Hormigón	Gris/beige	0.7-1.0	0.0	0.0	1.5	0.0
Madera	Madera	0.6-0.9	0.0	0.0	1.5	0.0

---

🎨 EFECTOS ESPECIALES

Emission (Brillo)

principled.inputs['Emission Color'].default_value = (1.0, 0.8, 0.2, 1.0)  # Luz cálida
principled.inputs['Emission Strength'].default_value = 5.0  # Intensidad

Clearcoat (Barniz/Cerámica)

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

Sheen (Tela/Terciopelo)

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 (Piel, cera, mármol)

principled.inputs['Subsurface Weight'].default_value = 0.3
principled.inputs['Subsurface Radius'].default_value = (1.0, 0.2, 0.1)  # Radio RGB de penetración
principled.inputs['Subsurface Color'].default_value = (1.0, 0.3, 0.1, 1.0)

Anisotropic (Superficies estriadas)

principled.inputs['Anisotropic'].default_value = 0.8
principled.inputs['Anisotropic Rotation'].default_value = 0.25  # 90°
# Se necesita entrada Tangent (UV o Geometry > Tangent)

---

🔗 СВЯЗИ

• Casos: Case 01: ArchViz, Case 03: Product Viz
• Flujos: WF 03: Texture Pipeline
• Prompts: P10 Node Groups, P11 Procedural Textures
• MCP Tool: set_material (básico), execute_blender_code (completo)
• Siguiente: P10: Node Group Creation