CombineMasksVideo 多路视频蒙版最大值像素合并节点
节点核心功能 (What is it?)
CombineMasksVideo 节点通过在时域的每一帧上执行逐像素最大值运算（Pixel-wise Maximum），将多路独立的视频遮罩蒙版（Mask Videos）融合成单一的复合蒙版视频。它能够智能兼容不同时间长度的视频，自动在较短的视频末尾补齐黑色静止帧以对齐时间轴。
典型适用场景 (When would I use it?)
在以下情况下使用 CombineMasksVideo 节点：
- 将多个追踪不同目标物体（如人物、车辆、文字）的视频蒙版合并为一个总遮罩；
- 聚合来自不同视觉 AI 识别与分割管线（如多个目标跟踪器）的遮罩数据；
- 制作多主体复合视频抠像或针对多区域的同步画面调色特效；
- 统一散落的局部动画遮罩层。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 CombineMasksVideo 节点。
- 将多路待合并的蒙版视频以列表形式连接至
mask_videos输入插槽。 - 执行工作流，合成后的单一视频蒙版将即刻生成。
参数输入插槽 (Parameters)
- mask_videos：待合并的遮罩蒙版视频列表（接收
list[VideoArtifact]或list[VideoUrlArtifact]）。
输出引脚 (Outputs)
- combined_mask：执行逐像素最大值并集融合后的全新复合蒙版视频工件。
底层运作原理解析 (How it works)
节点在底层对所有视频的所有对齐帧执行像素级最大值并集求解：
$$\text{Pixel}_{\text{out}}(t, x, y) = \max\Big(\text{Mask}_1(t, x, y),\, \text{Mask}_2(t, x, y),\, \dots,\, \text{Mask}_n(t, x, y)\Big)$$
- 色彩标准化：每一帧输入画面均自动转换为标准的单通道灰度图；
- 纯白像素并集：在输出蒙版中，只要任何一个输入蒙版在对应像素位置上呈现白色（高亮值），输出结果在该位置即恒为白色；
- 时序对齐与黑帧补齐 (Padding)：若输入的各个蒙版视频时长不一致，底层会自动以最长的视频为基准，在较短的视频尾端追加纯黑帧（RGB 0, 0, 0）补齐时间线。
典型工作流示例 (Example)
合并两个分别追踪行人和宠物的 AI 分割蒙版视频：
- 将人物追踪蒙版视频与宠物追踪蒙版视频一同接入 CombineMasksVideo 的
mask_videos列表输入插槽。 - 运行工作流。
- 输出的复合蒙版将在整段视频中同时高亮显示人物与宠物的遮罩轮廓。
关键技术特性 (Important Notes)
- 基准规格继承：合成视频的物理分辨率与输出帧率严格对齐接入的第一个视频（Reference Video）；
- 平滑进度呈现：节点卡片自带实时百分比进度指示（0–90% 逐帧最大值矩阵运算，90–100% FFmpeg 最终封装重组）；
- 高度稳定的容错性：黑帧补齐机制杜绝了因视频时长微小差异导致的对齐撕裂或处理中断。