Batch Crop From Mask (BatchCropFromMask) - ComfyUI-KJNodes

El nodo Batch Crop From Mask, desde una perspectiva de implementación técnica, recibe como entrada la imagen original de tipo IMAGE y la máscara de tipo MASK.

El nodo Batch Crop From Mask es una herramienta para el procesamiento por lotes de imágenes que puede identificar y recortar automáticamente las regiones objetivo en una imagen basándose en la máscara (Mask) proporcionada. La función principal de este nodo es analizar las regiones de píxeles distintos de cero en cada máscara, calcular el cuadro delimitador (Bounding Box) correspondiente y utilizar este rango para recortar la subimagen correspondiente de la imagen original.

Funcionalidad del Nodo

Desde una perspectiva de implementación técnica, este nodo recibe como entrada la imagen original de tipo IMAGE y la máscara de tipo MASK. Itera sobre cada par de imagen y máscara, calculando el rectángulo mínimo circunscrito a través de las coordenadas de los píxeles distintos de cero en la máscara. Este nodo admite el suavizado del tamaño del cuadro delimitador; el parámetro bbox_smooth_alpha permite ajustar el grado de mezcla entre el tamaño del cuadro delimitador del fotograma actual y el de los fotogramas históricos, lo que ayuda a obtener resultados de recorte más estables en el procesamiento de secuencias. El tamaño del cuadro delimitador calculado también se escala multiplicándolo por el coeficiente crop_size_mult, permitiendo ajustar de manera flexible el tamaño final de la región recortada.

Explicación de los Parámetros del Nodo - Batch Crop From Mask

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opción	Descripción
`original_images`	IMAGE	Sí	-	-	**：Secuencia de imágenes originales de salida, igual a la entrada. Tipo IMAGE.
`masks`	MASK	Sí	-	-	**：Secuencia de máscaras de entrada, utilizada para determinar la región objetivo que necesita ser recortada en la imagen original. Las regiones de píxeles distintos de cero en la máscara se calcularán como el cuadro delimitador. Tipo MASK.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opción	Descripción
`crop_size_mult`	FLOAT	Sí	1.0	0.0 - 10.0 (paso: 0.001)	**：Multiplicador del tamaño de recorte, utilizado para escalar el tamaño del cuadro delimitador calculado. Rango de valores de 0.0 a 10.0, con paso de 0.001.
`bbox_smooth_alpha`	FLOAT	Sí	0.5	0.0 - 1.0 (paso: 0.01)	**：Coeficiente de suavizado del cuadro delimitador, utilizado para mezclar el tamaño del cuadro delimitador del fotograma actual con el del fotograma anterior para lograr una transición suave. Rango de valores de 0.0 a 1.0, con paso de 0.01.

Salidas (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
original_images	IMAGE	**：Secuencia de imágenes originales de salida, igual a la entrada. Tipo IMAGE.
cropped_images	IMAGE	**：Secuencia de imágenes recortadas de salida. Tipo IMAGE.
bboxes	BBOX	**：Secuencia de coordenadas del cuadro delimitador de salida, en formato (x1, y1, x2, y2). Tipo BBOX.
width	INT	**：Ancho uniforme de las imágenes recortadas de salida. Tipo INT.
height	INT	**：Altura uniforme de las imágenes recortadas de salida. Tipo INT.

Casos de Uso

En flujos de trabajo reales, este nodo se utiliza comúnmente en escenarios que requieren enfocar una parte específica de una imagen. Por ejemplo, al crear animaciones o procesar secuencias de video, primero puedes usar un nodo generador de máscaras (como SAM o GroundingDino) para identificar el objeto principal en cada fotograma, y luego conectar la secuencia de máscaras generada y la secuencia de imágenes originales a este nodo. El nodo generará una secuencia de imágenes recortadas junto con las coordenadas del cuadro delimitador correspondiente. Estas salidas se pueden utilizar posteriormente para repintado local, superresolución o como entrada para otros nodos de procesamiento de imágenes.

Enlace al Código Fuente del Nodo Batch Crop From Mask

El nodo Batch Crop From Mask proviene del paquete de nodos ComfyUI-KJNodes.

Batch Crop From Mask(BatchCropFromMask)