> ## 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 材质 - ComfyUI Built-in Node Documentation

> 从文本描述生成完整、无缝平铺的 PBR 材质：一张基础贴图加上最多五张材质贴图，并可选择对贴图进行 SeedVR 放大。

从文本描述生成完整、无缝平铺的 PBR 材质：一张基础贴图加上最多五张材质贴图，并可选择对贴图进行 SeedVR 放大。输入图像可作为图生图（image-to-image）处理来引导结果，而带遮罩的输入图像则会将流程转为内补（inpaint）处理。借助此节点，无需扫描真实材质即可得到可直接用于游戏或 3D 的表面。

## 输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `prompt` | 要生成的材质或纹理的描述。 | STRING | 是 | 多行文本 |
| `image_size` | 输出纹理尺寸。设置为 `"custom"` 会显示 `width` 和 `height` 输入。默认：`"1:1 (1024x1024)"`。 | DYNAMIC\_COMBO | 是 | `"1:1 (1024x1024)"` `"1:1 (512x512)"` `"4:3 (1024x768)"` `"3:4 (768x1024)"` `"16:9 (1024x576)"` `"9:16 (576x1024)"` `"custom"` |
| `basecolor` | 生成 basecolor（反照率）贴图。默认：True。 | BOOLEAN | 是 | true false |
| `normal` | 生成法线贴图。默认：True。 | BOOLEAN | 是 | true false |
| `roughness` | 生成粗糙度贴图。默认：False。 | BOOLEAN | 是 | true false |
| `metalness` | 生成金属度贴图。默认：False。 | BOOLEAN | 是 | true false |
| `height` | 生成高度（置换）贴图。默认：False。 | BOOLEAN | 是 | true false |
| `upscale_factor` | 对 PBR 贴图进行无缝 SeedVR 放大。基础贴图不会被放大；4x 可将 2048 像素的贴图放大为 8K。默认：0（关闭）。 | INT | 是 | 0 到 4（步长：2） |
| `seed` | 用于可复现生成的种子。默认：42。 | INT | 是 | 0 到 2147483646 |
| `tiling_mode` | 平铺方向：全向、水平或垂直。高级设置。默认：`"both"`。 | COMBO | 是 | `"both"` `"horizontal"` `"vertical"` |
| `num_inference_steps` | 纹理生成的去噪步数。高级设置。默认：8。 | INT | 是 | 1 到 8 |
| `tile_size` | 潜空间中的分块尺寸，其中 64 表示 512 像素，128 表示 1024 像素。高级设置。默认：128。 | INT | 是 | 32 到 256（步长：2） |
| `tile_stride` | 潜空间中的分块步长。高级设置。默认：64。 | INT | 是 | 16 到 128（步长：2） |
| `image` | 可选的源图像。单独使用时执行图生图；与遮罩一起使用时执行内补处理。 | IMAGE | 否 | - |
| `mask` | 可选的内补遮罩，需要输入图像。白色区域会被重新生成，黑色区域会被保留。 | MASK | 否 | - |
| `strength` | 对输入图像的变换程度。仅在连接了图像时使用。高级设置。默认：0.6。 | FLOAT | 是 | 0.01 到 1.0（步长：0.01） |
| `prompt_expansion` | 使用语言模型扩展提示词，以获得更丰富的纹理细节。默认关闭，因为扩展会将提示词重新表述为一张照片，且往往会冲淡金属度贴图。高级设置。 | BOOLEAN | 是 | true false |
| `safety_checker` | 对请求运行提供方的内容安全检查。高级设置。默认：False。 | BOOLEAN | 是 | true false |

### 自定义图像尺寸输入

当 `image_size` 设置为 `"custom"` 时，这些输入会出现。

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `image_size.width` | 纹理宽度（像素）。默认：1024。 | INT | 是 | 512 到 2048（步长：16） |
| `image_size.height` | 纹理高度（像素）。默认：1024。 | INT | 是 | 512 到 2048（步长：16） |

**约束与行为：**

* 允许不启用任何材质贴图：此时节点只返回基础贴图，并且每个贴图输出都保持为 1x1 占位符。
* 遮罩需要输入图像；单独提供遮罩会引发错误。
* 8K 结果来自对 2048 像素渲染结果中的贴图进行 4x 放大，而不是来自单次 8K 生成。

## 输出

| 输出名 | 描述 | 数据类型 |
| - | - | - |
| `texture` | 材质的基础贴图，未应用任何贴图。 | IMAGE |
| `basecolor` | basecolor（反照率）贴图；当该贴图被禁用时为 1x1 占位符。 | IMAGE |
| `normal` | 法线贴图；当该贴图被禁用时为 1x1 占位符。 | IMAGE |
| `roughness` | 粗糙度贴图；当该贴图被禁用时为 1x1 占位符。 | IMAGE |
| `metalness` | 金属度贴图；当该贴图被禁用时为 1x1 占位符。 | IMAGE |
| `height` | 高度（置换）贴图；当该贴图被禁用时为 1x1 占位符。 | IMAGE |
| `expanded_prompt` | 提供方实际使用的提示词，仅当启用 `prompt_expansion` 时才会与输入不同。 | STRING |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/PatinaMaterialNode/zh.md)

***

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


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