> ## 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.

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

***

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