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

# LayersFromBoundingBoxes - ComfyUI Built-in Node Documentation

> Complete documentation for the LayersFromBoundingBoxes node in ComfyUI. Learn its inputs, outputs, parameters and usage.

이 노드는 이미지 배치와 해당 바운딩 박스를 레이어 스택으로 변환하여 프레임당 하나의 레이어를 생성하고 각 레이어를 일치하는 박스에 따라 배치합니다. 노드가 레이어를 배치(batch)로 출력할 때 사용하십시오. 배치(batch)는 모든 프레임에 대해 단일 위치만 전달하므로, 그렇지 않으면 개별 위치가 손실됩니다.

## 입력

| 매개변수              | 설명                                                                                                                                                                                                                                                                                                                             | 데이터 타입                          | 필수  | 범위                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- | --- | -------------------- |
| `image`           | 이미지 배치입니다. 각 프레임이 하나의 레이어가 됩니다.                                                                                                                                                                                                                                                                                                | IMAGE                           | 예   | —                    |
| `bboxes`          | 배치 상자로, 이미지 배치와 인덱스가 정렬됩니다. 바운딩 박스(x, y, width, height), 정규화된 요소("bbox" 포함 — 픽셀로 변환하려면 canvas\_width/canvas\_height가 필요함) 또는 둘 중 하나의 JSON 문자열을 허용합니다. 일치하는 박스가 없는 프레임은 원점에 배치됩니다. 박스의 너비/높이는 레이어를 해당 크기에 맞게 조정합니다. metadata.name(또는 desc) 및 metadata.z\_index는 있는 경우 사용되며, metadata.content\_rect(프레임 기준)는 프레임을 실제 콘텐츠로 크롭합니다. | BOUNDING\_BOX, ARRAY, or STRING | 예   | —                    |
| `mask`            | 프레임별 투명도로, 이미지 배치와 인덱스가 정렬됩니다(1 = 투명, LoadImage 규칙).                                                                                                                                                                                                                                                                           | MASK                            | 아니요 | —                    |
| `layers`          | 추가할 레이어 스택입니다. 연결하지 않으면 새 스택이 시작됩니다.                                                                                                                                                                                                                                                                                           | LAYERS                          | 아니요 | —                    |
| `crop_to_content` | 각 프레임을 metadata.content\_rect가 있는 경우 해당 영역으로 크롭하고, 콘텐츠를 박스 위치에 사각형 오프셋을 더해 배치합니다. 프레임이 패딩된 배치에서는 이 옵션을 켜 두십시오. 실제 콘텐츠만 원래 위치에 유지됩니다. (기본값: true)                                                                                                                                                                               | BOOLEAN                         | 아니요 | true<br />false      |
| `canvas_width`    | 문서 캔버스 너비입니다. 0이면 배치된 레이어에서 파생됩니다. (기본값: 0)                                                                                                                                                                                                                                                                                    | INT                             | 아니요 | 0 \~ MAX\_RESOLUTION |
| `canvas_height`   | 문서 캔버스 높이입니다. 0이면 배치된 레이어에서 파생됩니다. (기본값: 0)                                                                                                                                                                                                                                                                                    | INT                             | 아니요 | 0 \~ MAX\_RESOLUTION |

참고:

* `bboxes`와 `mask`는 `image`와 인덱스가 정렬되어야 합니다. n번째 박스와 n번째 마스크 프레임은 n번째 이미지 프레임에 대응됩니다. 일치하는 박스가 없는 프레임은 원점에 배치됩니다.
* `bboxes`에 정규화된 요소("bbox" 포함)가 포함된 경우, 정규화된 위치를 픽셀로 변환하려면 `canvas_width`와 `canvas_height`를 제공해야 합니다.
* `canvas_width`와 `canvas_height`가 모두 0보다 커야 문서 캔버스를 명시적으로 설정할 수 있습니다. 둘 중 하나라도 0이면 캔버스는 배치된 레이어에서 파생되거나 연결된 `layers` 스택에서 상속됩니다.
* `layers`가 연결되면 새 레이어가 해당 스택에 추가되고, 스택에 이미 있는 가장 높은 z-index 값보다 높은 z-index 값을 받습니다.
* `crop_to_content`가 활성화되고 프레임에 metadata.content\_rect가 있으면 프레임이 해당 사각형으로 크롭되고 박스의 너비/높이 배율은 적용되지 않습니다. 대신 사각형의 오프셋이 박스 위치에 더해집니다.

## 출력

| 출력 이름    | 설명                                             | 데이터 타입 |
| -------- | ---------------------------------------------- | ------ |
| `LAYERS` | Create Layered Image 노드에서 사용할 준비가 된 레이어 스택입니다. | LAYERS |

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

***

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