> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Material de pátina - ComfyUI Built-in Node Documentation

> Genera un material PBR completo que se repite sin costuras a partir de una descripción de texto: una textura base más hasta cinco mapas de material

Genera un material PBR completo que se repite sin costuras a partir de una descripción de texto: una textura base más hasta cinco mapas de material, con escalado SeedVR opcional de los mapas. Una imagen de entrada puede guiar el resultado como una pasada de imagen a imagen, y una imagen de entrada con una máscara lo convierte en una pasada de inpainting. Úsalo para producir superficies listas para juegos o para 3D sin escanear un material real.

## Entradas

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `prompt` | Descripción del material o la textura a generar. | STRING | Sí | Texto multilínea |
| `image_size` | Tamaño de la textura de salida. `"custom"` revela las entradas `width` y `height`. Predeterminado: `"1:1 (1024x1024)"`. | DYNAMIC\_COMBO | Sí | `"1:1 (1024x1024)"` `"1:1 (512x512)"` `"4:3 (1024x768)"` `"3:4 (768x1024)"` `"16:9 (1024x576)"` `"9:16 (576x1024)"` `"custom"` |
| `basecolor` | Genera el mapa de color base (albedo). Predeterminado: True. | BOOLEAN | Sí | true false |
| `normal` | Genera el mapa de normales. Predeterminado: True. | BOOLEAN | Sí | true false |
| `roughness` | Genera el mapa de rugosidad. Predeterminado: False. | BOOLEAN | Sí | true false |
| `metalness` | Genera el mapa de metalicidad. Predeterminado: False. | BOOLEAN | Sí | true false |
| `height` | Genera el mapa de altura (desplazamiento). Predeterminado: False. | BOOLEAN | Sí | true false |
| `upscale_factor` | Escalado SeedVR sin costuras de los mapas PBR. La textura base no se escala, y 4x convierte un mapa de 2048 píxeles en uno de 8K. Predeterminado: 0 (desactivado). | INT | Sí | 0 a 4 (paso: 2) |
| `seed` | Semilla para una generación reproducible. Predeterminado: 42. | INT | Sí | 0 a 2147483646 |
| `tiling_mode` | Dirección de mosaico: omnidireccional, horizontal o vertical. Ajuste avanzado. Predeterminado: `"both"`. | COMBO | Sí | `"both"` `"horizontal"` `"vertical"` |
| `num_inference_steps` | Pasos de eliminación de ruido para la generación de texturas. Ajuste avanzado. Predeterminado: 8. | INT | Sí | 1 a 8 |
| `tile_size` | Tamaño de mosaico en el espacio latente, donde 64 significa 512 píxeles y 128 significa 1024 píxeles. Ajuste avanzado. Predeterminado: 128. | INT | Sí | 32 a 256 (paso: 2) |
| `tile_stride` | Zancada de mosaico en el espacio latente. Ajuste avanzado. Predeterminado: 64. | INT | Sí | 16 a 128 (paso: 2) |
| `image` | Imagen de origen opcional. Por sí sola ejecuta una pasada de imagen a imagen; junto con una máscara ejecuta una pasada de inpainting. | IMAGE | No | - |
| `mask` | Máscara de inpainting opcional; requiere una imagen de entrada. Las áreas blancas se regeneran y las negras se conservan. | MASK | No | - |
| `strength` | Cuánto transformar la imagen de entrada. Solo se usa cuando se conecta una imagen. Ajuste avanzado. Predeterminado: 0.6. | FLOAT | Sí | 0.01 a 1.0 (paso: 0.01) |
| `prompt_expansion` | Expande el prompt con un modelo de lenguaje para obtener un detalle de textura más rico. Desactivado de forma predeterminada, porque la expansión reformula el prompt como una fotografía y tiende a diluir el mapa de metalicidad. Ajuste avanzado. | BOOLEAN | Sí | true false |
| `safety_checker` | Ejecuta la comprobación de seguridad de contenido del proveedor sobre la solicitud. Ajuste avanzado. Predeterminado: False. | BOOLEAN | Sí | true false |

### Entradas de tamaño de imagen personalizado

Estas entradas aparecen cuando `image_size` se establece en `"custom"`.

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `image_size.width` | Ancho de la textura en píxeles. Predeterminado: 1024. | INT | Sí | 512 a 2048 (paso: 16) |
| `image_size.height` | Alto de la textura en píxeles. Predeterminado: 1024. | INT | Sí | 512 a 2048 (paso: 16) |

**Restricciones y comportamiento:**

* Se permite no habilitar ningún mapa de material: el nodo entonces devuelve solo la textura base, y cada salida de mapa permanece como un marcador de posición de 1x1.
* Una máscara requiere una imagen de entrada; una máscara por sí sola genera un error.
* Un resultado de 8K proviene de escalar 4x los mapas de un render de 2048 píxeles, no de una única generación de 8K.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| - | - | - |
| `texture` | La textura base del material, sin ningún mapa aplicado. | IMAGE |
| `basecolor` | El mapa de color base (albedo), o un marcador de posición de 1x1 cuando ese mapa está deshabilitado. | IMAGE |
| `normal` | El mapa de normales, o un marcador de posición de 1x1 cuando ese mapa está deshabilitado. | IMAGE |
| `roughness` | El mapa de rugosidad, o un marcador de posición de 1x1 cuando ese mapa está deshabilitado. | IMAGE |
| `metalness` | El mapa de metalicidad, o un marcador de posición de 1x1 cuando ese mapa está deshabilitado. | IMAGE |
| `height` | El mapa de altura (desplazamiento), o un marcador de posición de 1x1 cuando ese mapa está deshabilitado. | IMAGE |
| `expanded_prompt` | El prompt que el proveedor usó realmente, que difiere de la entrada solo cuando `prompt_expansion` está habilitado. | STRING |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/PatinaMaterialNode/es.md)

***

**Source fingerprint (SHA-256):** `4e8305fa56a29dce72c54de12ae05207e8de39a1fea1f4753906c26e8af60383`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.