Image Batch Filter (ImageBatchFilter) - ComfyUI-KJNodes

El nodo Image Batch Filter recibe un lote de imágenes como entrada y permite al usuario definir un valor de color que represente "vacío" (como negro puro) y un umbral de tolerancia.

Image Batch Filter es un nodo de filtrado para el procesamiento por lotes de imágenes. Su función principal es identificar y eliminar automáticamente las imágenes "vacías" dentro de un lote. Lo hace comparando cada imagen con un color especificado para determinar si está vacía, ayudando así a los usuarios a limpiar datos de imagen no válidos y mejorar la eficiencia de los flujos de procesamiento posteriores.

Funcionalidad del Nodo

Este nodo recibe un lote de imágenes como entrada y permite al usuario definir un valor de color que represente "vacío" (como negro puro) y un umbral de tolerancia. Internamente, calcula la diferencia promedio entre cada imagen del lote y el color especificado. Si la diferencia está por debajo del umbral, la imagen se considera vacía. El usuario puede optar por eliminar directamente estas imágenes vacías o reemplazarlas con otra imagen de sustitución para mantener el tamaño del lote constante.

Especificación de Parámetros del Nodo - Image Batch Filter

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`images`	IMAGE	Sí	-	-	images (parámetro de salida): Lote de imágenes filtrado o reemplazado.
`replacement_image`	IMAGE	No	-	-	replacement_image (parámetro de entrada): Parámetro opcional, imagen utilizada para reemplazar las imágenes identificadas como vacías. Si no se proporciona, las imágenes vacías se eliminan directamente.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`empty_color`	STRING	Sí	0, 0, 0	-	empty_color (parámetro de entrada): Define el color considerado como "vacío". Formato: cadena "R, G, B", por ejemplo "0, 0, 0" representa negro puro.
`empty_threshold`	FLOAT	Sí	0.01	0.0 - 1.0 (paso: 0.01)	empty_threshold (parámetro de entrada): Umbral de tolerancia para determinar si una imagen está vacía. Rango de 0.0 a 1.0, paso 0.01. Un valor más pequeño implica un criterio más estricto.

Salidas (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
images	IMAGE	images (parámetro de salida): Lote de imágenes filtrado o reemplazado.
removed_indices	STRING	removed_indices (parámetro de salida): Índices de las imágenes que fueron eliminadas o reemplazadas en el lote original, devueltos como una cadena de texto.

Casos de Uso

En flujos de trabajo de generación de imágenes, si los nodos anteriores (como generación por lotes o carga de imágenes) pueden producir muchas imágenes de color plano o marcadores de posición no válidos, se puede utilizar este nodo para filtrarlas automáticamente. Por ejemplo, al combinar múltiples modelos LoRA para pruebas de estilo por lotes, este nodo puede filtrar las imágenes de color plano generadas incorrectamente, pasando solo las imágenes válidas a nodos posteriores de ampliación o combinación, asegurando un flujo de trabajo fluido.

Consideraciones

Este nodo requiere que la imagen de reemplazo (si se proporciona) tenga el mismo número de canales que las imágenes de entrada; de lo contrario, se realizará un escalado automático que podría afectar la calidad de la imagen. Además, la determinación del color vacío se basa en el promedio de píxeles, lo que puede no ser lo suficientemente preciso para imágenes "casi vacías" que contienen ruido sutil o textura, por lo que es necesario ajustar el umbral según la situación real.

Enlace al Código Fuente del Nodo Image Batch Filter

El nodo Image Batch Filter pertenece al paquete de nodos ComfyUI-KJNodes.

Image Batch Filter(ImageBatchFilter)