Batch Uncrop Advanced (BatchUncropAdvanced) - ComfyUI-KJNodes

Batch Uncrop Advanced 节点接收原始图像、裁剪后的图像、对应的裁剪遮罩、一个组合遮罩以及边界框数据作为输入。

Batch Uncrop Advanced 节点是一个高级图像处理节点，专门用于将经过裁剪和修改的图像片段精准地重新融合回原始背景图像中。其核心功能是处理批量图像，并支持使用遮罩和边界框来控制融合过程，以实现无缝的合成效果。

节点功能

此节点接收原始图像、裁剪后的图像、对应的裁剪遮罩、一个组合遮罩以及边界框数据作为输入。其技术实现依赖于这些遮罩和边界框信息来定位和混合图像。它支持对融合边缘进行羽化（通过 border_blending 参数），并允许对裁剪区域进行缩放（通过 crop_rescale 参数），以精细调整合成结果。

节点参数说明 - Batch Uncrop Advanced

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`original_images`	IMAGE	是	-	-	original_images（输入参数）：作为背景的原始完整图像，裁剪后的图像将被融合至此。输入图像数量需与 `cropped_images` 一致。
`cropped_images`	IMAGE	是	-	-	cropped_images（输入参数）：需要被贴回原始背景的裁剪后图像片段。数量必须与 `original_images` 相同。
`cropped_masks`	MASK	是	-	-	cropped_masks（输入参数）：与每个 `cropped_images` 对应的遮罩，用于定义每个裁剪片段中需要融合的有效区域。
`combined_crop_mask`	MASK	是	-	-	combined_crop_mask（输入参数）：一个组合遮罩，通常由所有裁剪区域的遮罩合并而成，用于定义整体可粘贴区域。
`bboxes`	BBOX	是	-	-	bboxes（输入参数）：边界框列表，指定每个 `cropped_images` 应被放置回 `original_images` 中的具体位置和范围。
`combined_bounding_box`	BBOX	否	-	-	combined_bounding_box（输入参数）：一个可选的边界框，用于定义组合遮罩的整体区域。如果未提供，则边界框将从各个 `bboxes` 推导得出。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`border_blending`	FLOAT	是	0.25	0.0 - 1.0 (步长: 0.01)	border_blending（输入参数）：控制融合边界的羽化强度，范围 0.0 到 1.0，步长 0.01。值越大，边缘过渡越平滑。
`crop_rescale`	FLOAT	是	1.0	0.0 - 10.0 (步长: 0.01)	crop_rescale（输入参数）：对 `cropped_images` 进行缩放的比例因子，范围 0.0 到 10.0，步长 0.01。1.0 表示保持原尺寸。
`use_combined_mask`	BOOLEAN	是	False	-	use_combined_mask（输入参数）：布尔值。为 True 时，使用 `combined_crop_mask` 进行全局融合控制；为 False 时，使用各个 `cropped_masks`。
`use_square_mask`	BOOLEAN	是	True	-	use_square_mask（输入参数）：布尔值。为 True 时，将遮罩形状处理为方形；为 False 时，保持遮罩原有形状。

输出 (Output)

参数名称	数据类型	说明
IMAGE	IMAGE	IMAGE（输出参数）：输出最终合成后的完整图像，所有裁剪片段已融合至原始背景中。

使用场景

一个典型应用是在“局部重绘”或“图像修复”工作流中。例如，用户可以先使用其他节点（如 Bounding Box 节点）从原始图像中框选出多个需要修改的区域，对这些区域分别进行重绘或编辑后，再使用此节点将所有修改后的区域一次性、自然地贴回原图，从而高效地完成多目标编辑。

注意事项

使用时需注意，输入的 original_images 和 cropped_images 两组图像的数量必须严格一致。如果提供的边界框（bboxes）数量多于图像数量，多余的边界框将被自动忽略。

Batch Uncrop Advanced 节点源码链接

Batch Uncrop Advanced 节点来自 ComfyUI-KJNodes 节点包。

Batch Uncrop Advanced(BatchUncropAdvanced)