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

# Patina Texture: materiales PBR y mapas con mosaico en ComfyUI

> Convierte una foto o un prompt en materiales PBR con mosaico perfecto en ComfyUI con Patina, más mapas de color base, normal, rugosidad, metalicidad y altura.

Patina genera los datos de superficie que necesita un recurso 3D. Una ejecución devuelve una textura base más los mapas basecolor, normal, rugosidad, metalicidad y altura que espera un material PBR, y todo el conjunto proviene del mismo latente, así que los mapas coinciden píxel a píxel en lugar de necesitar un bake por separado.

En ComfyUI, el proveedor se ejecuta a través de tres nodos asociados. **Patina Material** crea un material a partir de un prompt de texto, de una foto o de una foto más una máscara. **Patina Material Extract** extrae un material repetible de una foto que ya contiene la superficie que quieres. **Patina PBR Material Maps** convierte una imagen en el conjunto de mapas sin regenerar nada.

Los tres son nodos API en la nube. Requieren una cuenta de Comfy con créditos, no descargan ningún archivo de modelo y se cobran por ejecución. La insignia de precio de cada nodo muestra la tarifa actual, y cada mapa que actives la aumenta.

> [!TIP]
>
> Para usar los Nodos asociados, debes asegurarte de haber iniciado sesión correctamente y de estar utilizando un entorno de red permitido. Consulta la sección [Descripción general de los Nodos asociados](https://docs.comfy.org/es/tutorials/partner-nodes/overview.md) de la documentación para conocer los requisitos específicos de uso de los Nodos asociados.

> [!TIP]
>
> > [tab] Usuarios locales
> >
> > Asegúrate de que tu ComfyUI esté actualizado.
> >
> > * [Descargar ComfyUI](https://www.comfy.org/download)
> > * [Guía de actualización](https://docs.comfy.org/es/installation/update_comfyui.md)
> >
> > Los flujos de trabajo de esta guía se encuentran en las [Plantillas de flujos de trabajo](https://docs.comfy.org/es/interface/features/template.md).
> > Si no los encuentras en las plantillas, es posible que tu ComfyUI esté desactualizado.
> >
> > Si faltan nodos al cargar un flujo de trabajo, estas son las posibles razones:
> >
> > 1. No estás usando la última versión de ComfyUI (versión nocturna)
> > 2. Algunos nodos fallaron al importarse durante el inicio
>
> > [tab] Usuarios de Cloud
> >
> > * [Cloud](https://cloud.comfy.org) se actualizará después del lanzamiento estable de ComfyUI.
> >
> > Por lo tanto, si notas que falta algún nodo central en este documento, puede deberse a que los nuevos nodos centrales aún no se han publicado en la última versión estable. Espera al próximo lanzamiento estable.

## Flujos de trabajo disponibles

### Material Extract: de foto a material repetible

Apunta el nodo a una foto que ya contiene el material y el prompt indica qué superficie extraer y qué estructura conservar. La textura vuelve sin costuras, así que se repite sobre una superficie grande sin un borde visible.

![Vista previa del flujo de trabajo Patina Material Extract](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_extract-1.webp)

> [card] [Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=api_patina_material_extract\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Abrir en Comfy Cloud

> [card] [Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_extract.json)
>
> Descarga el JSON o busca "Patina: Material Extract" en la Biblioteca de plantillas

**Materiales de entrada**

> [card] [patina\_chair\_webbing.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_chair_webbing.png)
>
> Cárgala en el nodo `LoadImage`. Una foto que ya contiene el material

La foto no tiene que ser un recorte plano: el nodo vuelve a sintetizar la disposición, así que una foto de producto funciona siempre que el material en sí se repita. `strength` (avanzado, 0.6 en la plantilla) define cuánto puede alejarse la textura extraída de la foto.

### Material: de texto a material

Describe la superficie y obtén un material completo, sin ninguna imagen de origen. El prompt lleva todo el resultado, así que nombra el patrón y el acabado en lugar del objeto al que pertenece.

![Vista previa del flujo de trabajo Patina de texto a material](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_t2m-1.webp)

> [card] [Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=api_patina_material_t2m\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Abrir en Comfy Cloud

> [card] [Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_t2m.json)
>
> Descarga el JSON o busca "Patina: Text to Material" en la Biblioteca de plantillas

Los materiales estructurados salen mejor: madera, piedra, metal, tela, yeso y azulejo cerámico. Añadir "iluminación plana y uniforme, sin perspectiva" es lo que hace que el resultado se repita en mosaico en lugar de leerse como la fotografía de una pared.

### Material: de imagen a material

Conecta una foto de una superficie y Patina la redibuja como un material repetible, conservando el patrón de la imagen. `strength` decide cuánto se aleja de la foto: un valor bajo conserva la textura original y uno alto reescribe más de ella.

![Vista previa del flujo de trabajo Patina de imagen a material](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_i2m-1.webp)

> [card] [Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=api_patina_material_i2m\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Abrir en Comfy Cloud

> [card] [Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_i2m.json)
>
> Descarga el JSON o busca "Patina: Image to Material" en la Biblioteca de plantillas

**Materiales de entrada**

> [card] [patina\_brick\_wall.jpg](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_brick_wall.jpg)
>
> Cárgala en el nodo `LoadImage`. Una foto de superficie con una estructura regular

La entrada opcional `mask` limita el redibujado a una región, con blanco para regenerar y negro para conservar. Una máscara sin imagen provoca un error.

### PBR Maps: de imagen a conjunto de mapas

Deriva los mapas de una imagen que ya es el material. Aquí no se regenera nada: los mapas describen exactamente lo que contiene la imagen, así que las costuras, la perspectiva y la iluminación de la fuente permanecen en el resultado.

![Vista previa del flujo de trabajo Patina PBR Material Maps](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_pbr_maps-1.webp)

> [card] [Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=api_patina_pbr_maps\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Abrir en Comfy Cloud

> [card] [Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_pbr_maps.json)
>
> Descarga el JSON o busca "Patina: PBR Maps" en la Biblioteca de plantillas

**Materiales de entrada**

> [card] [patina\_pbr\_webbing\_basecolor.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_pbr_webbing_basecolor.png)
>
> Cárgala en el nodo `LoadImage`. Una superficie plana e iluminada de forma uniforme o un mapa basecolor existente

Este nodo no genera patrones repetibles. Úsalo cuando ya tengas un basecolor sin costuras y quieras el resto del conjunto, y usa Material o Material Extract cuando el resultado tenga que repetirse. Se aceptan entradas de hasta 2048 px; las imágenes más grandes se reducen a menos que desactives `auto_downscale`.

## Controles del nodo

| Control | Valores | Se aplica a | Efecto |
| - | - | - | - |
| `prompt` | texto | Material, Material Extract | Nombra la superficie o el material. En Extract, indica qué parte de la foto extraer. PBR Maps no tiene entrada de prompt |
| alternadores de mapas | `basecolor`, `normal`, `roughness`, `metalness`, `height` | los tres nodos | Qué mapas se devuelven. Los nodos parten con basecolor y normal activados y los otros tres desactivados, y las cuatro plantillas activan los cinco. Cada mapa activado suma al precio de la ejecución |
| `image_size` | `1:1 (1024x1024)`, `1:1 (512x512)`, `4:3 (1024x768)`, `3:4 (768x1024)`, `16:9 (1024x576)`, `9:16 (576x1024)`, `custom` | Material, Material Extract | Tamaño de salida. `custom` toma un ancho y un alto de 512 a 2048 en pasos de 16 |
| `upscale_factor` | `0`, `2`, `4` | Material, Material Extract | Ampliación sin costuras de los mapas. La textura base no se amplía, y `4` alcanza salidas de mapa de 8K desde una ejecución de 2K |
| `strength` | 0.01 a 1.0, por defecto 0.6 | Material, Material Extract | Cuánto puede alejarse el resultado de la foto fuente. Se ignora en text to material |
| `tiling_mode` | `both`, `horizontal`, `vertical` | Material, Material Extract | Dirección del mosaico |
| `num_inference_steps` | 1 a 8, por defecto 8 | Material, Material Extract | Pasos de eliminación de ruido. No hay nada que ganar por encima de 8 |
| `tile_size` | 32 a 256, por defecto 128 | Material, Material Extract | Tamaño del mosaico en el espacio latente: 64 equivale a unos 512 px, 128 a unos 1024 px |
| `tile_stride` | 16 a 128, por defecto 64 | Material, Material Extract | Paso del mosaico en el espacio latente |
| `prompt_expansion` | desactivado por defecto | Material, Material Extract | Reescritura del prompt por un LLM. Déjalo desactivado a menos que el prompt sea escaso, porque la expansión reformula el prompt como una foto y suele diluir el mapa de metalness |
| `seed` | entero | los tres nodos | Mantén la misma seed para repetir un resultado, cámbiala para obtener otra variación |
| `auto_downscale` | activado por defecto | PBR Maps | Escala una entrada cuyo lado más largo supere los 2048 px de vuelta a 2048 px. Desactívalo para obtener un error con imágenes demasiado grandes en su lugar |

Las salidas siguen un orden de ranuras fijo. Material y Material Extract devuelven `texture`, `basecolor`, `normal`, `roughness`, `metalness`, `height` y `expanded_prompt`. PBR Maps devuelve los cinco mapas sin una textura base separada. Un mapa desactivado sigue ocupando su ranura con un marcador negro de 1×1.

## Consejos

* **Nombra la superficie, no la escena.** En una foto de una silla, “chair webbing fabric” extrae las correas tejidas e ignora el marco, el suelo y la pala que aparece en la toma.
* **Añade estructura cuando el patrón se desvíe.** En Extract, una cláusula como “keep the weave and the strap edges” evita que el patrón se desvíe entre ejecuciones.
* **Elige un material que se repita en unos pocos cientos de píxeles.** Las correas, el ladrillo, los adoquines, las tablas y el yeso se repiten bien en mosaico. Un acantilado rocoso, un terreno aéreo o un objeto único regresan como un repintado que no se repite en mosaico.
* **Desactiva los mapas antes de ejecutar.** Tres mapas suelen bastar para un juego o un material de producto, y el precio depende del número de mapas. Desconecta o puentea el nodo SaveImage de ese mapa, o el marcador se guardará como si fuera un mapa.
* **Encadena Extract con PBR Maps para obtener un conjunto completo a partir de una sola foto.** Extract crea el mosaico de basecolor y luego PBR Maps deriva de él los mapas restantes.
* **Genera el mapa y luego revisa la metalicidad en los metales.** La expansión del prompt suele ser la causa de que una superficie metálica salga plana.

## Empezar

1. Actualiza ComfyUI a la última versión
2. Ve a Template Library y busca `Patina`
3. Elige el flujo de trabajo que coincida con tu entrada: Extract para una foto de una superficie, Text to Material para solo un prompt, Image to Material para redibujar una foto, PBR Maps para un basecolor existente
4. Desactiva los mapas que no necesites y luego ejecuta el flujo de trabajo


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