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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Painter/zh.md)

---
**Source fingerprint (SHA-256):** `ae926b6d30aab65737bd99a58cb7de5a71fa36e61a677dbc97fc30b8ef8d2418`