FilterZeroMasksAndCorrespondingImages

El nodo FilterZeroMasksAndCorrespondingImages recibe una lista de máscaras (MASK) como entrada obligatoria y, opcionalmente, puede recibir una lista de imágenes (IMAGE).

El nodo FilterZeroMasksAndCorrespondingImages es una herramienta para la limpieza y filtrado de datos. Su función principal es identificar y separar automáticamente las máscaras que están vacías (sin contenido), procesando de manera sincronizada las imágenes asociadas si se proporcionan. Con este nodo, los usuarios pueden organizar de manera eficiente los datos en su flujo de trabajo, eliminando las entradas de máscaras no válidas.

Funcionalidad del Nodo

Este nodo recibe una lista de máscaras (MASK) como entrada obligatoria y, opcionalmente, una lista de imágenes (IMAGE). Su mecanismo interno consiste en recorrer todas las máscaras de entrada y determinar si están vacías calculando el número de píxeles distintos de cero. Si se proporciona una lista de imágenes, el nodo verifica que su longitud coincida exactamente con la de la lista de máscaras y luego, según el resultado del filtrado de máscaras, realiza una agrupación sincronizada de las imágenes.

Especificación de Parámetros - FilterZeroMasksAndCorrespondingImages

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`masks`	MASK	Sí	-	-	masks (parámetro de entrada): Lista de máscaras de entrada que se van a filtrar. El nodo comprobará si cada máscara contiene píxeles distintos de cero.
`original_images`	IMAGE	No	-	-	original_images (parámetro de entrada): Lista opcional de imágenes de entrada. Su cantidad debe ser exactamente igual al número de máscaras en el parámetro `masks`.

Salidas (Outputs)

Nombre del Parámetro	Tipo de Dato	Descripción
non_zero_masks_out	MASK	non_zero_masks_out (parámetro de salida): Devuelve todas las máscaras válidas que no están vacías (con píxeles distintos de cero).
non_zero_mask_images_out	IMAGE	non_zero_mask_images_out (parámetro de salida): Devuelve las imágenes originales correspondientes a las máscaras no vacías.
zero_mask_images_out	IMAGE	zero_mask_images_out (parámetro de salida): Devuelve las imágenes originales correspondientes a las máscaras vacías.
zero_mask_images_out_indexes	INDEXES	zero_mask_images_out_indexes (parámetro de salida): Devuelve las posiciones de índice (en la lista de entrada original) de las máscaras vacías.

Casos de Uso

Este nodo es muy útil en flujos de trabajo que implican la generación por lotes de imágenes que requieren procesamiento posterior. Por ejemplo, un usuario puede generar primero un lote de imágenes y sus máscaras correspondientes usando múltiples prompts, y luego conectar los resultados a este nodo. El nodo filtrará automáticamente las máscaras que no generaron contenido válido, y enviará las máscaras con contenido y sus imágenes correspondientes para los siguientes pasos de refinamiento, mientras que las imágenes asociadas a máscaras vacías se enviarán por separado para su revisión.

Consideraciones

Si se proporciona una entrada de imágenes, su cantidad debe ser estrictamente igual a la cantidad de máscaras; de lo contrario, el nodo ignorará la entrada de imágenes y emitirá una advertencia. Este nodo no modifica el contenido de las máscaras o imágenes en sí, solo reagrupa y reindexa según si la máscara está completamente en cero o no.

Enlace al Código Fuente del Nodo FilterZeroMasksAndCorrespondingImages

El nodo FilterZeroMasksAndCorrespondingImages pertenece al paquete de nodos ComfyUI-KJNodes.