Batch Uncrop (BatchUncrop) - ComfyUI-KJNodes

Batch Uncrop 节点，该节点接收原始图像、裁剪后的图像以及对应的边界框（BBOX）数据作为输入

Batch Uncrop 节点是一个用于图像合成的工具，其核心功能是将经过裁剪处理后的图像，重新精确地放置回原始背景图像的指定位置。它通过接收边界框坐标来定位，并支持对拼接边缘进行平滑混合，以实现无缝的视觉融合效果。

节点功能

该节点接收原始图像、裁剪后的图像以及对应的边界框（BBOX）数据作为输入。其内部机制是根据边界框定义的坐标，将裁剪图像重新合成到原始图像的对应区域。它支持对重新放置的图像进行缩放调整，并通过可调节的混合强度来处理拼接边缘，以减少生硬的接缝。所有输入图像均需为批次格式，且数量需相互匹配。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`original_images`	IMAGE	是	-	-	original_images（输入参数）：作为背景的原始完整图像批次，裁剪后的图像将被融合回此图像中。
`cropped_images`	IMAGE	是	-	-	cropped_images（输入参数）：需要被重新放置回原始背景的裁剪后图像批次，数量需与原始图像一致。
`bboxes`	BBOX	是	-	-	bboxes（输入参数）：定义裁剪图像在原始图像中位置的边界框坐标批次，用于精确定位。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`border_blending`	FLOAT	是	0.25	0.0 - 1.0 (步长: 0.01)	border_blending（输入参数）：控制拼接边缘的混合强度，范围 0.0 到 1.0，值越大融合越平滑。
`crop_rescale`	FLOAT	是	1.0	0.0 - 10.0 (步长: 0.01)	crop_rescale（输入参数）：在融合前对裁剪图像进行缩放的比例因子，范围 0.0 到 10.0。
`border_top`	BOOLEAN	是	True	-	border_top（输入参数）：布尔值，控制是否对重新放置图像的上边缘应用混合效果。
`border_bottom`	BOOLEAN	是	True	-	border_bottom（输入参数）：布尔值，控制是否对重新放置图像的下边缘应用混合效果。
`border_left`	BOOLEAN	是	True	-	border_left（输入参数）：布尔值，控制是否对重新放置图像的左边缘应用混合效果。
`border_right`	BOOLEAN	是	True	-	border_right（输入参数）：布尔值，控制是否对重新放置图像的右边缘应用混合效果。

参数名称	数据类型	说明
IMAGE	IMAGE	IMAGE（输出参数）：输出合成后的最终图像批次。

一个典型的使用场景是在人像修复工作流中：先使用检测节点框出人脸区域并裁剪放大进行细节修复（如去瑕疵、增强分辨率），然后使用 Batch Uncrop 节点将修复后的人脸图像无缝融合回原始照片的对应位置，从而得到一张局部增强的整体图像。

使用时需确保输入的 original_images 和 cropped_images 两个图像批次的数量严格一致。如果提供的边界框（bboxes）数量多于图像数量，节点会自动丢弃多余的边界框。