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

El nodo Batch Crop From Mask Advanced toma imágenes (IMAGE) y máscaras (MASK) como entrada y determina el área de recorte calculando la Caja Delimitadora de los píxeles distintos de cero en la máscara.

Batch Crop From Mask Advanced es un nodo avanzado de recorte de imágenes capaz de identificar automáticamente y recortar por lotes las regiones objetivo de las imágenes originales basándose en las máscaras proporcionadas. Su función principal es extraer con precisión las regiones de interés definidas por las máscaras de un conjunto de imágenes, generando como salida las imágenes y máscaras recortadas junto con información relevante de las Cajas Delimitadoras.

Funcionalidad del Nodo

Este nodo recibe imágenes (IMAGE) y máscaras (MASK) como entrada y determina el área de recorte calculando la Caja Delimitadora de los píxeles distintos de cero en la máscara. Admite procesamiento por lotes e incorpora un mecanismo de suavizado de la Caja Delimitadora. El parámetro bbox_smooth_alpha ajusta la suavidad de la transición entre la posición y el tamaño de la Caja Delimitadora del fotograma actual y el anterior, lo que resulta especialmente útil para mantener la estabilidad del recorte al procesar secuencias de vídeo o imágenes. Además, el parámetro crop_size_mult permite al usuario ampliar proporcionalmente el área de recorte, asegurando que el objeto objetivo quede completamente incluido.

Especificación de Parámetros del Nodo - Batch Crop From Mask Advanced

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`original_images`	IMAGE	Sí	-	-	original_images (Parámetro de Entrada): Las imágenes originales de las que se recortarán las regiones objetivo. Estas se pasan sin cambios a la salida.
`masks`	MASK	Sí	-	-	masks (Parámetro de Entrada): Introduce la secuencia de máscaras correspondiente a las imágenes originales, utilizada para definir la región objetivo que se debe recortar en cada imagen.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`crop_size_mult`	FLOTANTE	Sí	1.0	0.0 - 10.0 (incremento: 0.01)	crop_size_mult (Parámetro de Entrada): Multiplicador del tamaño de recorte. Se utiliza para ampliar proporcionalmente la Caja Delimitadora original calculada a partir de la máscara. Rango de 0.0 a 10.0, con incremento de 0.01.
`bbox_smooth_alpha`	FLOTANTE	Sí	0.5	0.0 - 1.0 (incremento: 0.01)	bbox_smooth_alpha (Parámetro de Entrada): Coeficiente de suavizado de la Caja Delimitadora. Se utiliza para suavizar los cambios en la posición y el tamaño de la Caja Delimitadora entre fotogramas de imagen consecutivos. Rango de 0.0 a 1.0, con incremento de 0.01.

Salidas (Outputs)

Nombre del Parámetro	Tipo de Dato	Descripción
original_images	IMAGE	original_images (Parámetro de Salida): Genera como salida las imágenes originales de entrada sin modificar, facilitando la concatenación del Flujo de trabajo.
cropped_images	IMAGE	cropped_images (Parámetro de Salida): Genera como salida las imágenes recortadas según cada máscara.
cropped_masks	MASK	Máscaras recortadas en la misma región.
combined_crop_image	IMAGE	combined_crop_image (Parámetro de Salida): Genera como salida una única imagen formada al unir todas las imágenes recortadas.
combined_crop_masks	MASK	combined_crop_masks (Parámetro de Salida): Genera como salida una única máscara formada al unir todas las máscaras recortadas.
bboxes	BBOX	bboxes (Parámetro de Salida): Genera como salida una lista de coordenadas de Cajas Delimitadoras calculadas para cada imagen de entrada.
combined_bounding_box	BBOX	combined_bounding_box (Parámetro de Salida): Genera como salida una Caja Delimitadora general que puede englobar todas las Cajas Delimitadoras individuales.
bbox_width	ENTERO	bbox_width (Parámetro de Salida): Genera como salida el valor del Ancho de `combined_bounding_box`.
bbox_height	ENTERO	bbox_height (Parámetro de Salida): Genera como salida el valor del Alto de `combined_bounding_box`.

Casos de Uso

En aplicaciones prácticas, este nodo se utiliza comúnmente en Flujos de trabajo que requieren extraer objetos específicos de una serie de imágenes para su posterior procesamiento. Por ejemplo, al crear animaciones de personajes o presentaciones de productos, primero se puede usar un modelo de segmentación para generar máscaras del objeto objetivo, luego introducir las imágenes originales y las máscaras en este nodo para obtener un conjunto de imágenes recortadas de tamaño uniforme que contengan solo ese objeto. Estas imágenes pueden pasarse convenientemente a otros nodos para repintado, transferencia de estilo o composición.

Consideraciones

Tenga en cuenta que las imágenes y máscaras de entrada deben coincidir en tamaño de lote. Si una máscara está completamente Vacía (es decir, no tiene píxeles distintos de cero), el nodo devolverá un área de recorte vacía. El parámetro de suavizado solo tiene un efecto significativo al procesar fotogramas consecutivos (por ejemplo, VÍDEO); su efecto es limitado para imágenes individuales o desordenadas.

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

El nodo Batch Crop From Mask Advanced pertenece al paquete de nodos ComfyUI-KJNodes.

Batch Crop From Mask Advanced(BatchCropFromMaskAdvanced)