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

The Add Layer 节点将输入图像转换为图层并将其放置在画布上，可以开始新的图层堆栈，或将图层追加到现有堆栈。您可以设置图层的名称、位置、大小、旋转、不透明度、混合模式、堆叠顺序以及水平或垂直翻转。此节点标记为实验性。

## 输入

| 参数           | 描述                                                             | 数据类型    | 必填 | 范围                                 |
| ------------ | -------------------------------------------------------------- | ------- | -- | ---------------------------------- |
| `layers`     | 要追加到的图层堆栈。保持未连接以开始新的堆栈。                                        | LAYERS  | 否  | —                                  |
| `image`      | 以其原始尺寸显示的图层内容。批次会展开为连续的图层。                                     | IMAGE   | 是  | —                                  |
| `mask`       | 此图层的透明度遮罩。遮罩区域（值 1）变为透明，并与图像已携带的任何 Alpha 通道相乘。                 | 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 模式会产生透明效果。（默认值："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/zh.md)

***

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