Image Crop By Mask (ImageCropByMask) - ComfyUI-KJNodes

Image Crop By Mask 节点接收 IMAGE 和 MASK 两种类型的张量输入。

Image Crop By Mask 节点是一个图像处理工具，它能够根据用户提供的遮罩自动裁剪输入图像。其核心功能是识别遮罩中的有效区域，并以此区域为边界框，精确地裁剪掉图像中不需要的部分，仅保留与遮罩对应的内容。

节点功能

此节点接收 IMAGE 和 MASK 两种类型的张量输入。在内部，它会将遮罩二值化（通过 round() 方法），然后为输入批次中的每一张图像独立计算遮罩非零像素的最小外接矩形（即边界框）。最后，节点会依据这个边界框对原始图像进行裁剪，并将所有裁剪后的图像重新组合后输出。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	是	-	-	image（输入参数）：要裁剪的原始图像。
`mask`	MASK	是	-	-	mask（输入参数）：用于定义裁剪区域的遮罩。类型为 `MASK` 张量，无默认值，无特定取值范围限制。

参数名称	数据类型	说明
image	IMAGE	image（输出参数）：输出裁剪后的图像结果。

在图像修复或局部重绘工作流中，此节点非常有用。例如，当您使用 VAEEncode 和 KSampler 生成了图片的遮罩区域后，可以将原图和遮罩同时输入此节点，以快速获得仅包含目标区域的图像切片，便于进行后续的图像放大、细节增强或与其他图像合成等操作。

此节点要求输入的图像（image）和遮罩（mask）在批次维度上兼容。如果批次大小不一致，节点会通过索引 min(b, mask.shape[0]-1) 来循环使用最后一个遮罩，这可能不是所有情况下的预期行为，使用时需注意数据对齐。