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

このノードは、画像バッチとそのバウンディングボックスをレイヤースタックに変換し、フレームごとに1つのレイヤーを作成して、各レイヤーを対応するボックスに従って配置します。ノードがレイヤーをバッチとして出力する場合に使用してください。バッチは全フレームに対して単一の配置しか保持しないため、個々の位置が失われてしまうからです。

## 入力

| パラメータ             | 説明                                                                                                                                                                                                                                                                                                                               | データ型                           | 必須  | 範囲                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | --- | ----------------- |
| `image`           | 画像バッチ。各フレームが1つのレイヤーになります。                                                                                                                                                                                                                                                                                                        | IMAGE                          | はい  | —                 |
| `bboxes`          | 配置ボックス。画像バッチとインデックスが一致します。バウンディングボックス (x, y, width, height)、正規化要素（"bbox" を含む。ピクセルに変換するには canvas\_width/canvas\_height が必要）、またはそれらのいずれかの JSON 文字列を受け入れます。一致するボックスがないフレームは原点に配置されます。ボックスの幅/高さは、レイヤーが収まるようにスケーリングします。metadata.name（または desc）と metadata.z\_index は存在する場合に使用され、metadata.content\_rect（フレーム相対）はフレームを実際のコンテンツにトリミングします。 | BOUNDING\_BOX、ARRAY、または 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/ja.md)

***

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