Batch Crop From Mask Advanced (BatchCropFromMaskAdvanced) - ComfyUI-KJNodes

Batch Crop From Mask Advanced 节点接收图像（IMAGE）和遮罩（MASK）作为输入，通过计算遮罩中非零像素的边界框来确定裁剪区域。

Batch Crop From Mask Advanced 是一个高级图像裁剪节点，能够根据提供的遮罩自动识别并批量裁剪原始图像中的目标区域。其核心功能是精确地从一组图像中提取出由遮罩定义的感兴趣区域，并输出裁剪后的图像和遮罩，同时提供相关的边界框信息。

节点功能

此节点接收图像（IMAGE）和遮罩（MASK）作为输入，通过计算遮罩中非零像素的边界框来确定裁剪区域。它支持批处理，并引入了边界框平滑机制。bbox_smooth_alpha 参数用于调整当前帧与上一帧边界框位置和大小之间的过渡平滑度，这在处理视频或图像序列时对保持裁剪稳定性非常有用。此外，crop_size_mult 参数允许用户按比例放大裁剪区域，确保目标物体被完整包含。

节点参数说明 - Batch Crop From Mask Advanced

连接输入（Inputs）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`original_images`	IMAGE	是	-	-	original_images（输入参数）：原始图像，目标区域将从这些图像中裁剪。这些图像会原样传递到输出。
`masks`	MASK	是	-	-	masks（输入参数）：输入与原始图像对应的遮罩序列，用于定义每个图像中需要裁剪的目标区域。

控件参数（Parameters）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`crop_size_mult`	FLOAT	是	1.0	0.0 - 10.0（步长：0.01）	crop_size_mult（输入参数）：裁剪尺寸乘数，用于按比例放大基于遮罩计算出的原始边界框。范围 0.0 至 10.0，步长 0.01。
`bbox_smooth_alpha`	FLOAT	是	0.5	0.0 - 1.0（步长：0.01）	bbox_smooth_alpha（输入参数）：边界框平滑系数，用于在连续图像帧间平滑边界框的位置和大小变化。范围 0.0 至 1.0，步长 0.01。

输出（Outputs）

参数名称	数据类型	说明
original_images	IMAGE	original_images（输出参数）：原样输出输入的原始图像，便于工作流串联。
cropped_images	IMAGE	cropped_images（输出参数）：输出根据每个遮罩裁剪得到的图像。
cropped_masks	MASK	经过相同区域裁剪的遮罩。
combined_crop_image	IMAGE	combined_crop_image（输出参数）：输出将所有裁剪图像拼接组合后的单一图像。
combined_crop_masks	MASK	combined_crop_masks（输出参数）：输出将所有裁剪遮罩拼接组合后的单一遮罩。
bboxes	BBOX	bboxes（输出参数）：输出为每个输入图像计算得到的边界框坐标列表。
combined_bounding_box	BBOX	combined_bounding_box（输出参数）：输出一个能包围所有单个边界框的总体边界框。
bbox_width	INT	bbox_width（输出参数）：输出 `combined_bounding_box` 的宽度值。
bbox_height	INT	bbox_height（输出参数）：输出 `combined_bounding_box` 的高度值。

使用场景

在实际应用中，此节点常用于需要从一系列图像中提取特定对象并进行后续处理的工作流。例如，在制作角色动画或产品展示时，你可以先使用一个分割模型生成目标物体的遮罩，然后将原始图像和遮罩输入此节点，从而获得一组只包含该物体的、尺寸统一的裁剪图像，这些图像可以方便地送入其他节点进行重绘、风格转换或合成。

注意事项

请注意，输入的图像和遮罩在批次大小上需要匹配。如果遮罩完全为空（即没有非零像素），节点将返回一个空的裁剪区域。平滑参数仅当处理连续帧（如视频）时效果显著，对于单张或无序的图像，其作用有限。

Batch Crop From Mask Advanced 节点源码链接

Batch Crop From Mask Advanced 节点来自 ComfyUI-KJNodes 节点包。

Batch Crop From Mask Advanced(BatchCropFromMaskAdvanced)