文档 /
节点说明 /
创建分层图像
创建分层图像
此节点将多个图像图层合并为单个合成图像。它接收使用 Add Layer 节点构建的图层堆栈,并可选择应用合成器编辑器中保存的合成设置,根据图层的放置、大小、旋转、不透明度和混合模式来混合图层。
节点说明
ImageCompositor 更新于 2026-11-12
创建分层图像 - ComfyUI Built-in Node Documentation
此节点将多个图像图层合并为单个合成图像。它接收使用 Add Layer 节点构建的图层堆栈,并可选择应用合成器编辑器中保存的合成设置,根据图层的放置、大小、旋转、不透明度和混合模式来混合图层。
此节点将多个图像图层合并为单个合成图像。它接收使用 Add Layer 节点构建的图层堆栈,并可选择应用合成器编辑器中保存的合成设置,根据图层的放置、大小、旋转、不透明度和混合模式来混合图层。与当前输入匹配的已保存合成将优先使用;否则,节点将根据图层属性进行合成,并将已保存状态标记为过期。
输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
layers | 要合成的图层堆栈;使用 Add Layer 构建。项按 z_index 堆叠,项内的批量帧会展开为连续的图层,项的放置、不透明度和混合模式定义初始合成。如果没有显式的文档画布,大小将是已放置图层的最大范围(尽力而为)。与当前输入匹配的已保存合成将优先使用。 | LAYERS | 是 | 最多 50 层 |
compositor | 由合成器编辑器保存的分层合成。 | COMPOSITOR | 否 | None |
约束说明:
- 图层堆栈最多支持 50 个展开图层;提供更多会引发错误。
- 目前仅支持光栅图层项;其他项类型会引发错误。
layers文档版本必须为 1;其他版本会引发错误。- 仅当记录的输入指纹与当前图层堆栈匹配时,才会重放已保存的
compositor状态。如果它们不匹配,节点将回退到根据图层属性进行合成,并将已保存状态标记为过期。 - 图层不透明度被限制在 0.0 到 1.0 的范围内。
- 图层的水平和垂直放置(
x、y)被限制在最大分辨率限制内。 - 当图层宽度和高度设置为零或更小时,会回退到自然图像大小,并受最大分辨率限制。
- 合成画布大小不得超过最大分辨率限制。
- 当未提供图层时,返回 64x64 占位图像。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
IMAGE | 合成图像。当合成具有透明区域(例如隐藏背景)时携带 Alpha 通道,否则为纯 RGB。 | IMAGE |
MASK | 合成的透明度(1 = 完全透明)。当合成不透明时全为零。 | MASK |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): 76e5e57ade89f9ee172c5e1f0b82579d846d15bafb52b2052246f1f2ad7f0034