> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ImageCompositor - ComfyUI Built-in Node Documentation

> 此节点将多个图像图层合并为单个合成图像。

此节点将多个图像图层合并为单个合成图像。它接收使用 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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCompositor/zh.md)

***

**Source fingerprint (SHA-256):** `76e5e57ade89f9ee172c5e1f0b82579d846d15bafb52b2052246f1f2ad7f0034`