ComfyPilotComfyPilot
文档 / 节点说明 / 添加图层

添加图层

The Add Layer 节点将输入图像转换为图层并将其放置在画布上,可以开始新的图层堆栈,或将图层追加到现有堆栈。

节点说明 AddLayer 更新于 2026-11-12

查看官方原文

添加图层 - ComfyUI Built-in Node Documentation

The Add Layer 节点将输入图像转换为图层并将其放置在画布上,可以开始新的图层堆栈,或将图层追加到现有堆栈。

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

输入

参数描述数据类型必填范围
图层组要追加到的图层堆栈。保持未连接以开始新的堆栈。LAYERS否—
图像以其原始尺寸显示的图层内容。批次会展开为连续的图层。IMAGE是—
遮罩此图层的透明度遮罩。遮罩区域(值 1)变为透明,并与图像已携带的任何 Alpha 通道相乘。MASK否—
名称合成器编辑器中显示的图层名称。(默认值:"")STRING否—
X在画布上的初始水平位置。(默认值:0)INT否-MAX\_RESOLUTION 到 MAX\_RESOLUTION
Y在画布上的初始垂直位置。(默认值:0)INT否-MAX\_RESOLUTION 到 MAX\_RESOLUTION
不透明度初始图层不透明度。(默认值:1.0)FLOAT否0.0 到 1.0 (步长 0.01)
混合模式初始混合模式,应用于下方的图层。在默认透明背景上的底层上,非 normal 模式会产生透明效果。(默认值:"normal")COMBO否多个选项可用
旋转初始旋转角度,顺时针方向。(默认值:0.0)FLOAT否-360.0 到 360.0 (步长 1.0)
宽度初始显示宽度。0 表示保持图像的原始宽度。(默认值:0)INT否0 到 MAX\_RESOLUTION
高度初始显示高度。0 表示保持图像的原始高度。(默认值:0)INT否0 到 MAX\_RESOLUTION
层级堆叠顺序覆盖。图层按 z\_index 稳定排序;相同值保持列表顺序。(默认值:0)INT否-1000 到 1000
水平翻转水平翻转图层。(默认值:False)BOOLEAN否false / true
垂直翻转垂直翻转图层。(默认值: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