Patina Material Extract - ComfyUI Built-in Node Documentation - ComfyUI

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

Source fingerprint (SHA-256): 484b8eaa57388541e352cd88c8998c63aa0b2a99d98cd8e602252625064f16ba