> ## 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 ノードで構築されたレイヤースタックを受け取り、必要に応じてコンポジターエディターで保存されたコンポジション設定を適用し、レイヤーをその配置、サイズ、回転、不透明度、ブレンドモードに従ってブレンドします。現在の入力と一致する保存済みコンポジションがある場合はそれが優先されます。それ以外の場合、ノードはレイヤープロパティから合成し、保存済み状態を stale（古い）としてマークします。

## 入力

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

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

* レイヤースタックは最大50の展開済みレイヤーをサポートします。それより多い場合、エラーが発生します。
* 現在、ラスターレイヤー項目のみがサポートされています。他の項目タイプはエラーを発生させます。
* `layers` ドキュメントのバージョンは1でなければなりません。他のバージョンはエラーを発生させます。
* 保存された `compositor` 状態は、記録された入力フィンガープリントが現在のレイヤースタックと一致する場合にのみ再生されます。一致しない場合、ノードはレイヤープロパティからの合成にフォールバックし、保存状態を stale（古い）としてマークします。
* レイヤーの不透明度は 0.0 ～ 1.0 の範囲にクランプされます。
* レイヤーの水平および垂直配置（`x`、`y`）は、最大解像度制限にクランプされます。
* レイヤーの幅と高さは、0以下に設定されると元の画像サイズにフォールバックし、最大解像度制限で上限が適用されます。
* 合成キャンバスサイズは最大解像度制限を超えてはなりません。
* レイヤーが指定されていない場合、64x64 のプレースホルダー画像が返されます。

## 出力

| 出力名     | 説明                                                                 | データ型  |
| ------- | ------------------------------------------------------------------ | ----- |
| `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):** `76e5e57ade89f9ee172c5e1f0b82579d846d15bafb52b2052246f1f2ad7f0034`