内置节点参考
Painter - ComfyUI Built-in Node Documentation
Complete documentation for the Painter node in ComfyUI. Learn its inputs, outputs, parameters and usage.
Painter 节点提供了一个交互式画布，用于直接在 ComfyUI 中创建或编辑图像和遮罩。它允许您从空白画布或现有图像开始，使用画笔工具进行绘制，并输出最终图像和相应的 Alpha 遮罩。遮罩定义了绘制区域，这些区域随后会合成到基础图像或背景颜色之上。
输入
| 参数 | 描述 | 数据类型 | 是否必需 | 范围 |
|---|---|---|---|---|
图像 |
可选的基础图像，用于在其上进行绘制。如果未提供，则会使用指定的背景颜色、宽度和高度创建空白画布。 | IMAGE | 否 | - |
mask |
绘制数据，通常由节点内置的交互式小部件生成。此参数由 UI 的绘图工具管理，不应连接到标准插槽。 | STRING | 是 | - |
宽度 |
画布的宽度（以像素为单位），在未提供基础 图像 时使用。该值必须是 64 的倍数。默认为 512。 |
INT | 是 | 64 到 4096 |
高度 |
画布的高度（以像素为单位），在未提供基础 图像 时使用。该值必须是 64 的倍数。默认为 512。 |
INT | 是 | 64 到 4096 |
背景颜色 |
画布的背景颜色，以十六进制代码指定（例如 #000000）。仅在未提供基础 图像 时使用。默认为黑色（#000000）。 |
COLOR | 是 | - |
注意： mask 输入设计用于与节点的专用 UI 小部件配合使用。当您在画布上绘制时，小部件会自动填充此值。width 和 height 输入在标准 UI 中隐藏，但在创建新图像时定义画布尺寸。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
IMAGE |
最终的合成图像。这是将绘制区域（来自 mask）混合到提供的基础 图像 或彩色背景上的结果。 |
IMAGE |
MASK |
从绘图中提取的 Alpha 通道（透明度）遮罩。白色区域代表绘制的区域，黑色区域代表未触及的背景。 | MASK |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): ae926b6d30aab65737bd99a58cb7de5a71fa36e61a677dbc97fc30b8ef8d2418
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。