AddLayer - ComfyUI Built-in Node Documentation - ComfyUI

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 上编辑

Source fingerprint (SHA-256): b7bf1a012d17cb5768b49d5c0617e13562ba015f695e6c9b1d1bbefba4150f9e