CombineMasks 多蒙版像素并集融合与合并节点
节点核心功能 (What is it?)
CombineMasks 节点通过在每个像素点上取所有输入蒙版的最大值 (Maximum Value per Pixel)，将一组分立的蒙版图像融合为一个统一的合并蒙版（布尔并集 Union 操作）。
当目标检测或图像分割算法同时识别出画面中的多个离散目标，并为每个对象生成了独立的子蒙版时，该节点能够快速将它们融合为一张单一、完整的总选区蒙版，以便供下游修图或重绘算子统一使用。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 将多个独立的分割蒙版（Segmentation Masks）融合成一个总遮罩；
- 将画面中检测到的多个人物、物品或多处前景合并为一个统一的“复合主体蒙版”；
- 简化工作流拓扑，将下游仅接收单蒙版输入的节点与上游多对象输出安全对接。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 CombineMasks 节点。
- 将包含一个或多个蒙版图像的列表连接至
masks输入插槽。 - 从
output_mask引脚即可提取融合成型的全选区合并蒙版。
参数输入插槽 (Parameters)
- masks：待合并的蒙版图像列表（List of mask images，接收
ImageArtifact或ImageUrlArtifact列表）。
输出引脚 (Outputs)
- output_mask：执行最大值像素融合后生成的全新复合单通道蒙版工件（无损 PNG 编码）。
关键技术特性 (Important Notes)
- 逐像素并集逻辑 (Union Logic)：对于画布上的每一个物理像素 $(x, y)$，输出蒙版的亮度为所有输入蒙版对应位置亮度的最大极值： $$\text{Pixel}_{\text{out}}(x, y) = \max(\text{Mask}_1(x, y), \text{Mask}_2(x, y), \dots, \text{Mask}_n(x, y))$$
- 几何尺寸刚性一致性 (Size Requirement)：参与合并的所有输入蒙版图像必须具有完全相同的物理像素宽高。若检测到尺寸不匹配，节点会中断并抛出明确的校验错误提示。
- 透明度自适应解析 (Alpha Handling)：若输入蒙版为 RGBA 或 LA 模式，节点自动提取其 Alpha 透明度通道进行并集运算；若为常规 RGB/灰度图，则自动转换为标准灰度亮度后再行融合。