> ## 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 Material Extract - ComfyUI Built-in Node Documentation

> Extracts a seamlessly tiling PBR material from a region of an input image, guided by a prompt that names what to take: a wall, a floor, a fabric.

Extracts a seamlessly tiling PBR material from a region of an input image, guided by a prompt that names what to take: a wall, a floor, a fabric. It returns the extracted base texture plus up to five material maps, with optional SeedVR upscaling of the maps. Use it to turn a photo of a real surface into a reusable, tileable material.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `image` | The image to extract a texture from. | IMAGE | Yes | - |
| `prompt` | Description of which texture to extract from the image, for example `"the wall"`. | STRING | Yes | Multiline text |
| `image_size` | Output texture size. `"custom"` reveals `width` and `height` inputs. Default: `"1:1 (1024x1024)"`. | DYNAMIC\_COMBO | Yes | `"1:1 (1024x1024)"` `"1:1 (512x512)"` `"4:3 (1024x768)"` `"3:4 (768x1024)"` `"16:9 (1024x576)"` `"9:16 (576x1024)"` `"custom"` |
| `basecolor` | Generate the basecolor (albedo) map. Default: True. | BOOLEAN | Yes | true false |
| `normal` | Generate the normal map. Default: True. | BOOLEAN | Yes | true false |
| `roughness` | Generate the roughness map. Default: False. | BOOLEAN | Yes | true false |
| `metalness` | Generate the metalness map. Default: False. | BOOLEAN | Yes | true false |
| `height` | Generate the height (displacement) map. Default: False. | BOOLEAN | Yes | true false |
| `upscale_factor` | Seamless SeedVR upscaling of the PBR maps. The base texture is not upscaled, and 4x turns a 2048-pixel map into an 8K one. Default: 0 (off). | INT | Yes | 0 to 4 (step 2) |
| `seed` | Seed for reproducible generation. Default: 42. | INT | Yes | 0 to 2147483646 |
| `strength` | How much to transform the input image. Advanced setting. Default: 0.6. | FLOAT | Yes | 0.01 to 1.0 (step 0.01) |
| `tiling_mode` | Tiling direction: omnidirectional, horizontal or vertical. Advanced setting. Default: `"both"`. | COMBO | Yes | `"both"` `"horizontal"` `"vertical"` |
| `num_inference_steps` | Denoising steps for texture generation. Advanced setting. Default: 8. | INT | Yes | 1 to 8 |
| `tile_size` | Tile size in latent space, where 64 means 512 pixels and 128 means 1024 pixels. Advanced setting. Default: 128. | INT | Yes | 32 to 256 (step 2) |
| `tile_stride` | Tile stride in latent space. Advanced setting. Default: 64. | INT | Yes | 16 to 128 (step 2) |
| `prompt_expansion` | Expand the prompt with a language model for richer texture detail. Off by default, because expansion reframes the prompt as a photograph and tends to wash out the metalness map. Advanced setting. | BOOLEAN | Yes | true false |
| `safety_checker` | Run the provider's content safety check on the request. Advanced setting. Default: False. | BOOLEAN | Yes | true false |

### custom Image Size Inputs

These inputs appear when `image_size` is set to `"custom"`.

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `image_size.width` | Texture width in pixels. Default: 1024. | INT | Yes | 512 to 2048 (step 16) |
| `image_size.height` | Texture height in pixels. Default: 1024. | INT | Yes | 512 to 2048 (step 16) |

**Constraints and behavior:**

* Enabling no material map is allowed: the node then returns only the base texture, and every map output stays a 1x1 placeholder.
* The prompt is required and must not be empty; name the region to extract as precisely as possible.
* An 8K result comes from 4x upscaling the maps of a 2048-pixel render, not from a single 8K generation.

## Outputs

| Output Name | Description | Data Type |
| - | - | - |
| `texture` | The extracted base texture, without any map applied. | IMAGE |
| `basecolor` | The basecolor (albedo) map, or a 1x1 placeholder when that map is disabled. | IMAGE |
| `normal` | The normal map, or a 1x1 placeholder when that map is disabled. | IMAGE |
| `roughness` | The roughness map, or a 1x1 placeholder when that map is disabled. | IMAGE |
| `metalness` | The metalness map, or a 1x1 placeholder when that map is disabled. | IMAGE |
| `height` | The height (displacement) map, or a 1x1 placeholder when that map is disabled. | IMAGE |
| `expanded_prompt` | The prompt the provider actually used, which differs from the input only when `prompt_expansion` is enabled. | STRING |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/PatinaMaterialExtractNode/en.md)

***

**Source fingerprint (SHA-256):** `484b8eaa57388541e352cd88c8998c63aa0b2a99d98cd8e602252625064f16ba`


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