> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ImageCompositor - ComfyUI Built-in Node Documentation

> 이 노드는 여러 이미지 레이어를 단일 합성 이미지로 결합합니다.

이 노드는 여러 이미지 레이어를 단일 합성 이미지로 결합합니다. Add Layer 노드로 만든 레이어 스택을 입력으로 받고, 선택적으로 컴포지터 편집기에서 저장한 합성 설정을 적용하여 레이어의 배치, 크기, 회전, 불투명도 및 블렌드 모드에 따라 레이어를 블렌딩합니다. 현재 입력과 일치하는 저장된 합성이 있으면 우선 적용되며, 그렇지 않으면 노드가 레이어 속성으로 합성하고 저장된 상태를 오래된 것으로 표시합니다.

## 입력

| 매개변수         | 설명                                                                                                                                                                                                               | 데이터 타입     | 필수  | 범위         |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --- | ---------- |
| `layers`     | 합성할 레이어 스택입니다. Add Layer로 만듭니다. 항목은 z\_index를 기준으로 쌓이고, 항목 내부의 배치 프레임은 연속 레이어로 확장되며, 항목의 배치, 불투명도 및 블렌드 모드가 초기 합성을 정의합니다. 명시적인 문서 캔버스가 없으면 크기는 배치된 레이어의 최대 범위를 최대한 반영한 값이 됩니다. 현재 입력과 일치하는 저장된 합성이 있으면 우선 적용됩니다. | LAYERS     | 예   | 최대 50개 레이어 |
| `compositor` | 컴포지터 편집기에서 저장한 레이어 합성입니다.                                                                                                                                                                                        | COMPOSITOR | 아니요 | 없음         |

**제약 사항:**

* 레이어 스택은 최대 50개의 확장 레이어를 지원합니다. 더 많이 제공하면 오류가 발생합니다.
* 현재 래스터 레이어 항목만 지원됩니다. 다른 항목 유형을 제공하면 오류가 발생합니다.
* `layers` 문서 버전은 1이어야 합니다. 다른 버전은 오류를 발생시킵니다.
* 저장된 `compositor` 상태는 기록된 입력 지문이 현재 레이어 스택과 일치할 때만 재생됩니다. 일치하지 않으면 노드는 레이어 속성으로 합성하는 방식으로 대체하고 저장된 상태를 오래된 것으로 표시합니다.
* 레이어 불투명도는 0.0\~1.0 범위로 클램프됩니다.
* 레이어의 가로 및 세로 배치(`x`, `y`)는 최대 해상도 한도로 클램프됩니다.
* 레이어 너비와 높이가 0 이하로 설정되면 원본 이미지 크기로 대체되며, 최대 해상도 한도로 제한됩니다.
* 합성된 캔버스 크기는 최대 해상도 한도를 초과해서는 안 됩니다.
* 레이어가 제공되지 않으면 64x64 자리 표시자 이미지가 반환됩니다.

## 출력

| 출력 이름   | 설명                                                                      | 데이터 타입 |
| ------- | ----------------------------------------------------------------------- | ------ |
| `IMAGE` | 합성 이미지입니다. 합성 결과에 투명 영역(예: 숨겨진 배경)이 있으면 알파 채널을 포함하고, 그렇지 않으면 일반 RGB입니다. | IMAGE  |
| `MASK`  | 합성 결과의 투명도입니다(1 = 완전 투명). 합성이 불투명하면 모두 0입니다.                            | MASK   |

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

***

**Source fingerprint (SHA-256):** `76e5e57ade89f9ee172c5e1f0b82579d846d15bafb52b2052246f1f2ad7f0034`