> ## 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 내에서 직접 이미지나 마스크를 생성하거나 편집할 수 있는 대화형 캔버스를 제공합니다. 빈 캔버스나 기존 이미지로 시작하여 브러시 도구로 그림을 그리고, 결과 이미지와 해당 알파 마스크를 모두 출력할 수 있습니다. 마스크는 그려진 영역을 정의하며, 이 영역은 기본 이미지나 배경색 위에 합성됩니다.

## 입력

| 매개변수   | 설명                                                                                            | 데이터 타입 | 필수 여부 | 범위         |
| ------ | --------------------------------------------------------------------------------------------- | ------ | ----- | ---------- |
| `이미지`  | 덧그릴 기본 이미지입니다(선택 사항). 제공되지 않으면 지정된 배경색, 너비 및 높이를 사용하여 빈 캔버스가 생성됩니다.                           | IMAGE  | 아니요   | -          |
| `mask` | 일반적으로 노드의 내장 대화형 위젯에 의해 생성되는 페인팅 데이터입니다. 이 매개변수는 UI의 페인터 도구에 의해 관리되며, 표준 소켓에 연결하기 위한 것이 아닙니다. | STRING | 예     | -          |
| `너비`   | 기본 `이미지`가 제공되지 않을 때 사용되는 캔버스의 너비(픽셀)입니다. 값은 64의 배수여야 합니다. 기본값은 512입니다.                        | INT    | 예     | 64 \~ 4096 |
| `높이`   | 기본 `이미지`가 제공되지 않을 때 사용되는 캔버스의 높이(픽셀)입니다. 값은 64의 배수여야 합니다. 기본값은 512입니다.                        | INT    | 예     | 64 \~ 4096 |
| `배경색`  | 캔버스의 배경색으로, 16진수 코드(예: #000000)로 지정됩니다. 기본 `이미지`가 제공되지 않을 때만 사용됩니다. 기본값은 검은색(#000000)입니다.     | COLOR  | 예     | -          |

**참고:** `mask` 입력은 노드의 특수 UI 위젯과 함께 작동하도록 설계되었습니다. 캔버스에 그림을 그리면 위젯이 자동으로 이 값을 채웁니다. `width` 및 `height` 입력은 표준 UI에서는 숨겨져 있지만, 새 이미지를 생성할 때 캔버스 크기를 정의합니다.

## 출력

| 출력 이름   | 설명                                                                           | 데이터 타입 |
| ------- | ---------------------------------------------------------------------------- | ------ |
| `IMAGE` | 최종 합성 이미지입니다. 제공된 기본 `이미지` 또는 색상 배경 위에 그려진 영역(`mask`에서 가져옴)을 혼합한 결과입니다.      | IMAGE  |
| `MASK`  | 페인팅에서 추출한 알파 채널(투명도) 마스크입니다. 흰색 영역은 그려진 영역을 나타내고, 검은색 영역은 변경되지 않은 배경을 나타냅니다. | MASK   |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Painter/ko.md)

***

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