> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-12fd5b4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TextOverlay - ComfyUI Built-in Node Documentation

> 이 노드는 이미지 또는 이미지 배치 위에 텍스트를 그립니다. 사용자 정의 가능한 글꼴 크기, 색상, 위치, 정렬 및 선택적 윤곽선을 사용하여 텍스트 오버레이를 생성한 후, 텍스트를 원본 이미지 위에 합성합니다.

이 노드는 이미지 또는 이미지 배치 위에 텍스트를 그립니다. 사용자 정의 가능한 글꼴 크기, 색상, 위치, 정렬 및 선택적 윤곽선을 사용하여 텍스트 오버레이를 생성한 후, 텍스트를 원본 이미지 위에 합성합니다.

## 입력

| 매개변수                                                                                     | 설명                                                                                                          | 데이터 타입  | 필수 | 범위                                      |
| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------- | -- | --------------------------------------- |
| `images`                                                                                 | 텍스트를 그릴 입력 이미지 또는 이미지 배치                                                                                    | IMAGE   | 예  |                                         |
| `text`                                                                                   | 이미지 위에 오버레이할 텍스트 (기본값: ""). 여러 줄을 지원합니다. `\n` 및 `\t` 이스케이프 시퀀스는 줄바꿈과 탭으로 변환되며, 텍스트는 이미지 너비에 맞게 자동으로 줄바꿈됩니다. | STRING  | 예  |                                         |
| `font_size`                                                                              | 이미지 높이 대비 글꼴 크기 백분율 (기본값: 5.0)                                                                              | FLOAT   | 예  | 0.5 \~ 50.0 (0.5 간격)                    |
| `color`                                                                                  | 텍스트 색상 (기본값: "#ffffff")                                                                                     | STRING  | 예  |                                         |
| `position`                                                                               | 이미지에서 텍스트의 세로 위치 (기본값: "top")                                                                               | COMBO   | 예  | `"top"`<br />`"bottom"`                 |
| `align`                                                                                  | 텍스트의 가로 정렬 (기본값: "left")                                                                                    | COMBO   | 예  | `"left"`<br />`"center"`<br />`"right"` |
| `outline`                                                                                | 텍스트 주위에 검은색 윤곽선 그리기 (기본값: True)                                                                             | BOOLEAN | 예  |                                         |
| 참고: `text`가 비어 있거나 공백만 포함된 경우, 노드는 입력 이미지를 변경 없이 반환합니다. 동일한 텍스트 오버레이가 배치의 모든 이미지에 적용됩니다. |                                                                                                             |         |    |                                         |

## 출력

| 출력 이름    | 설명                   | 데이터 타입 |
| -------- | -------------------- | ------ |
| `images` | 텍스트 오버레이가 합성된 입력 이미지 | IMAGE  |

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

***

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