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

# ImageCompositor - ComfyUI Built-in Node Documentation

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

このノードは、複数の画像レイヤーを1つの合成画像に結合します。Add Layer ノードで構築されたレイヤースタックと、必要に応じてコンポジターエディターで保存された合成状態を受け取り、各レイヤーの配置・サイズ・回転・不透明度・ブレンドモードの設定に基づいてレイヤーをブレンドします。

## 入力

| パラメータ        | 説明                                                                                                                                                                                                                   | データ型       | 必須  | 範囲       |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --- | -------- |
| `layers`     | 合成対象のレイヤースタック。Add Layer で構築します。アイテムは z\_index によって積み重ねられ、アイテム内のバッチフレームは連続するレイヤーに展開されます。アイテムの配置・不透明度・ブレンドモードが初期合成を定義します。明示的なドキュメントキャンバスがない場合、サイズは配置されたレイヤーの最大範囲を最善努力で計算したものになります。現在の入力と一致する保存済みの合成状態がある場合は、それが優先されます。 | LAYERS     | はい  | 最大50レイヤー |
| `compositor` | コンポジターエディターによって保存されたレイヤー合成状態。                                                                                                                                                                                        | COMPOSITOR | いいえ | なし       |

**制約事項に関する注記:**

* レイヤースタックは最大50レイヤー（展開後のフレーム）に対応しています。これを超えるとエラーが発生します。
* 現在サポートされているのはラスターレイヤーのみです。その他のレイヤーアイテムタイプではエラーが発生します。
* `layers` ドキュメントのバージョンは1である必要があります。それ以外のバージョンではエラーが発生します。
* 保存された `compositor` 状態は、記録された入力フィンガープリントが現在のレイヤースタックと一致する場合にのみ再生されます。一致しない場合、ノードはレイヤープロパティからの合成にフォールバックし、保存済み状態を古いものとしてマークします。
* レイヤーの不透明度は0.0～1.0の範囲にクランプされます。
* レイヤーの水平・垂直方向の配置（`x`、`y`）は、最大解像度制限にクランプされます。
* レイヤーの幅と高さは、0以下に設定された場合、自然な画像サイズにフォールバックし、最大解像度制限で上限が設定されます。
* 合成キャンバスのサイズは最大解像度制限を超えてはなりません。

## 出力

| 出力名     | 説明                                                                | データ型  |
| ------- | ----------------------------------------------------------------- | ----- |
| `IMAGE` | 合成された画像。合成結果に透明領域がある場合（例：非表示の背景）はアルファチャンネルを含み、それ以外の場合は通常のRGB画像です。 | IMAGE |
| `MASK`  | 合成結果の透明度（1 = 完全に透明）。合成結果が不透明な場合はすべてゼロになります。                       | MASK  |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCompositor/ja.md)

***

**Source fingerprint (SHA-256):** `1eca5c151b3737ccf76e6fd7a83cd1458b2acc314609753d597eec711bcf4bd8`