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

# AddLayer - ComfyUI Built-in Node Documentation

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

Add Layer ノードは、入力画像をレイヤーに変換してキャンバス上に配置し、新しいレイヤースタックを開始するか、既存のレイヤースタックに追加します。レイヤーの名前、位置、サイズ、回転、不透明度、ブレンドモード、重なり順、水平・垂直方向の反転を設定できます。このノードは実験的機能としてマークされています。

## 入力

| パラメータ        | 説明                                                                                     | データ型    | 必須  | 範囲                                  |
| ------------ | -------------------------------------------------------------------------------------- | ------- | --- | ----------------------------------- |
| `layers`     | 追加先のレイヤースタック。未接続のままにすると新しいスタックが開始されます。                                                 | LAYERS  | いいえ | —                                   |
| `image`      | ネイティブサイズでのレイヤーコンテンツ。バッチは連続したレイヤーに展開されます。                                               | IMAGE   | はい  | —                                   |
| `mask`       | このレイヤーの透明マスク。マスクされた領域（値1）は透明になり、画像がすでに持つアルファチャンネルと乗算されます。                              | MASK    | いいえ | —                                   |
| `name`       | コンポジターエディターに表示されるレイヤー名。（デフォルト: ""）                                                     | STRING  | いいえ | —                                   |
| `x`          | キャンバス上の初期水平位置。（デフォルト: 0）                                                               | INT     | いいえ | -MAX\_RESOLUTION から MAX\_RESOLUTION |
| `y`          | キャンバス上の初期垂直位置。（デフォルト: 0）                                                               | INT     | いいえ | -MAX\_RESOLUTION から MAX\_RESOLUTION |
| `opacity`    | 初期レイヤー不透明度。（デフォルト: 1.0）                                                                | FLOAT   | いいえ | 0.0 から 1.0（ステップ: 0.01）              |
| `blend_mode` | 初期ブレンドモード。下のレイヤーに対して適用されます。最下レイヤーでデフォルトの透明背景に対しては、通常モード以外では透明が生成されます。（デフォルト: "normal"） | COMBO   | いいえ | 複数のオプションから選択可能                      |
| `rotation`   | 初期回転角度（度、時計回り）。（デフォルト: 0.0）                                                            | FLOAT   | いいえ | -360.0 から 360.0（ステップ: 1.0）          |
| `width`      | 初期表示幅。0 の場合は画像のネイティブ幅が維持されます。（デフォルト: 0）                                                | INT     | いいえ | 0 から MAX\_RESOLUTION                |
| `height`     | 初期表示高さ。0 の場合は画像のネイティブ高さが維持されます。（デフォルト: 0）                                              | INT     | いいえ | 0 から MAX\_RESOLUTION                |
| `z_index`    | 重なり順の上書き。レイヤーは z\_index で安定ソートされ、同じ値の場合はリスト順が保持されます。（デフォルト: 0）                         | INT     | いいえ | -1000 から 1000                       |
| `flip_h`     | レイヤーを水平方向に反転します。（デフォルト: False）                                                         | BOOLEAN | いいえ | false / true                        |
| `flip_v`     | レイヤーを垂直方向に反転します。（デフォルト: False）                                                         | BOOLEAN | いいえ | false / true                        |

注記：

* 必須なのは `image` のみで、他の入力はすべてオプションです。
* `layers` が未接続の場合、新しいレイヤースタックが作成されます。レイヤースタックが接続されている場合、新しいレイヤーはそのスタックに追加されます。
* `image` 入力の画像のバッチは、複数の連続したレイヤーを作成します。
* `width` と `height` はデフォルトで 0 になり、画像のネイティブ寸法が維持されます。0 より大きい値を指定すると表示サイズが上書きされます。
* `opacity`、`blend_mode`、`rotation`、`width`、`height` は、デフォルト値と異なる場合にのみ適用されます。
* 接続されたレイヤースタックのキャンバスサイズは、出力でも保持されます。

## 出力

| 出力名      | 説明                    | データ型   |
| -------- | --------------------- | ------ |
| `layers` | このレイヤーが追加されたレイヤースタック。 | LAYERS |

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

***

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