Image Crop By Mask Batch (ImageCropByMaskBatch) - ComfyUI-KJNodes

Image Crop By Mask Batch 节点，该节点接收图像（IMAGE）和遮罩（MASK）作为输入，遮罩用于定义图像中需要保留的区域。

Image Crop By Mask Batch 节点是一个高效的图像处理工具，它能够根据提供的遮罩批量裁剪输入图像。其核心功能是自动识别遮罩区域，并将该区域从原图中精确提取出来，生成新的图像和对应的遮罩。

节点功能

该节点接收图像（IMAGE）和遮罩（MASK）作为输入，遮罩用于定义图像中需要保留的区域。节点会计算每个遮罩的有效区域边界框，并根据指定的宽度、高度和填充值进行裁剪。如果遮罩尺寸与图像不匹配，节点会自动进行插值调整。裁剪后的区域会被放置在新画布的中心，并支持自定义背景颜色。

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

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`width`	INT	是	-	-	width（输入参数）：裁剪后输出图像的宽度。
`height`	INT	是	-	-	height（输入参数）：裁剪后输出图像的高度。
`padding`	INT	是	0	0 - 4096 (步长: 1)	padding（输入参数）：在遮罩区域边界框外额外扩展的像素数，范围 0 至 4096。
`preserve_size`	BOOLEAN	是	False	-	preserve_size（输入参数）：若为 True，则忽略 width 和 height 参数，输出图像保持原始尺寸。
`bg_color`	STRING	是	-	-	颜色，可以是 RGB 值（0-255 或 0.0-1.0）、颜色名称或十六进制代码。

参数名称	数据类型	说明
images	IMAGE	images（输出参数）：根据遮罩裁剪后生成的图像集合。
masks	MASK	经过裁剪和调整后的遮罩。

在图像修复或局部重绘工作流中，此节点非常有用。例如，你可以先用一个遮罩生成节点（如 SAM 或遮罩编辑器）标记出图像中需要修改的部分（如人脸），然后使用本节点将标记区域裁剪出来，单独进行细节调整或风格化处理，最后再合成回原图。

请注意，输入的遮罩必须是单通道的二值图，其中白色（或非零值）区域表示需要保留的部分。如果遮罩完全为黑色（即没有有效区域），该遮罩对应的图像将不会被处理。