Consolidate Masks (ConsolidateMasksKJ) - ComfyUI-KJNodes

Consolidate Masks 节点接收一个蒙版批次作为输入，并分析每个蒙版的有效区域边界框。

Consolidate Masks 节点是一个用于优化和管理蒙版批处理的工具。它的核心功能是将多个独立的蒙版智能地合并到指定尺寸的图块中，从而减少处理批次的数量，提升后续处理效率。

节点功能

该节点接收一个蒙版批次作为输入，并分析每个蒙版的有效区域边界框。其核心算法会寻找能够容纳在指定宽度和高度（包含内边距）内的最大蒙版组，并将它们合并。此过程会迭代进行，直到没有更多蒙版可以组合，最终输出一个经过整合的新蒙版批次。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`masks`	MASK	是	-	-	masks（输入参数）：需要被合并的原始蒙版批次。类型为 MASK。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`width`	INT	是	512	0 - 4096 (步长: 64)	width（输入参数）：目标合并图块的宽度，范围 0 至 4096，调整步长为 64。
`height`	INT	是	512	0 - 4096 (步长: 64)	height（输入参数）：目标合并图块的高度，范围 0 至 4096，调整步长为 64。
`padding`	INT	是	0	0 - 4096 (步长: 1)	padding（输入参数）：合并时蒙版之间的内边距，范围 0 至 4096，调整步长为 1。

参数名称	数据类型	说明
MASK	MASK	MASK（输出参数）：经过合并优化后输出的新蒙版批次。

在需要对大量小物体或区域进行分别处理的工作流中，例如批量修复图像中的多个瑕疵或为多个独立元素生成内容，此节点非常有用。你可以将分割得到的多个蒙版输入此节点，它会自动将它们打包到更少的图块中，然后你可以将整合后的蒙版批次送入一个图像修复节点进行统一处理，从而避免对每个蒙版进行单独推理，节省计算资源。

该节点要求输入的蒙版是二值化的，并且其合并逻辑基于蒙版的外接矩形，因此对于形状极度不规则或分散的蒙版，合并效率可能受到影响。输出的蒙版批次尺寸由输入蒙版的数量和合并结果决定。