Image Uncrop By Mask (ImageUncropByMask) - ComfyUI-KJNodes

Image Uncrop By Mask 节点，该节点接收目标图像、源图像、遮罩和边界框作为输入

Image Uncrop By Mask 节点用于将源图像根据指定的遮罩和边界框，无缝地合成到目标图像的特定区域。其核心功能是执行一种“反向裁剪”操作，允许用户精确地将一个图像元素嵌入到另一个图像的指定位置，并利用遮罩实现平滑融合。

节点功能

该节点接收目标图像、源图像、遮罩和边界框作为输入。在内部，它会根据边界框的尺寸，使用 Lanczos 算法对源图像进行上采样，并使用双线性插值对遮罩进行上采样。随后，通过计算填充值，将调整后的源图像和遮罩精确地放置到目标图像的对应坐标位置，最终输出合成后的完整图像。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
destination	IMAGE	是	-	-	destination（输入参数）：作为背景的目标图像，源图像将被合成到此图像上。
source	IMAGE	是	-	-	source（输入参数）：需要被合成到目标图像上的源图像。
mask	MASK	是	-	-	mask（输入参数）：定义源图像中哪些部分应被合成到目标图像的遮罩，通常为单通道。
bbox	BBOX	是	-	-	用于指定源图像在目标图像中的放置位置和范围的边界框。

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

一个典型的使用场景是，在修复或编辑图像时，用户可以先使用其他节点（如 Bounding Box 检测器）确定需要替换的区域，然后使用此节点将新的图像内容（如修复后的片段）精准地贴回原图。这常见于人脸替换、物体移除后填充或局部风格迁移等工作流中。