Apply Mask

Esta función filtra una imagen usando una imagen de máscara (blanco/negro o escala de grises) para conservar o eliminar partes específicas de la imagen de entrada. Está pensada para flujos de trabajo sencillos de segmentación y enmascarado en AugeLab Studio.

📥 Entradas

• Image — Imagen principal que se va a filtrar (socket de entrada).

• Mask — Imagen de máscara que define las áreas a conservar (socket de entrada). Acepta imágenes binarias, en escala de grises o en color. El bloque interpretará píxeles claros/blancos de la máscara como áreas a conservar y los píxeles oscuros como áreas a eliminar.

📤 Salidas

• Filtered — Imagen resultante tras aplicar la máscara (socket de salida).

🕹️ Controles

Este bloque no tiene controles adicionales ni widgets. Realiza el enmascarado basándose en las dos entradas proporcionadas.

🎨 Características

• Funciona con imágenes en color (RGB) y en escala de grises.

• Acepta máscaras en escala de grises o color; la máscara se interpreta como un mapa conservar/eliminar.

• Conserva los píxeles de la imagen donde la máscara es clara/blanca y oculta los píxeles donde la máscara es oscura/negra.

• Diseñado para filtrado visual rápido dentro de cadenas de procesamiento.

⚙️ Mecanismo de ejecución

Al evaluarse, el bloque verifica ambas entradas, asegura que la máscara pueda usarse como selector binario y aplica la máscara a la imagen principal. La salida es la imagen original con las áreas no enmascaradas eliminadas (o puestas en negro) según la máscara.

📝 Instrucciones de uso

1. Proporcione la imagen que desea filtrar en la entrada Image.

2. Proporcione una imagen de máscara en la entrada Mask. Las regiones claras/blancas de la máscara se conservarán en la salida; las regiones oscuras/negras se eliminarán.

3. Conecte la salida Filtered a bloques posteriores (para visualización, guardado o procesamiento adicional).

Consejos:

• Si la máscara y la imagen difieren en tamaño, redimensione o recórtelas para que coincidan antes de conectarlas.

• Si su máscara es una segmentación burda, combine este bloque con pasos morfológicos o de suavizado para refinar los resultados.

💡 Consejos y trucos

• Genere máscaras a partir de valores de intensidad usando los bloques Image Threshold o Image Adaptive Threshold antes de conectarlos a este bloque.

• Reduzca el ruido en la fuente de la máscara usando Blur o Denoising para evitar pequeños huecos no deseados en el resultado.

• Mejore la separación de primer plano/fondo con HSV Filter cuando el color sea un indicio fuerte; luego convierta ese resultado en una máscara para este bloque.

• Para extracción de sujetos de mayor calidad, pruebe Background Removal (RMBG-1.4) o Background Removal (BiRefNet) y alimente la máscara o el recorte resultante en este bloque.

• Use Morphological Transformations para limpiar pequeños artefactos de la máscara (erosionar/dilatar) antes de aplicar la máscara.

• Recorte o centre el procesamiento con Image ROI Select o Image ROI para que la máscara y la imagen se alineen en el área de interés.

• Previsualice resultados con Show Image y guarde salidas exitosas usando Image Logger o Image Write.

🛠️ Solución de problemas

• La máscara parece no hacer nada: Verifique que la Mask esté alineada con la Image y que las áreas claras correspondan a las regiones que espera conservar. Si los tamaños difieren, use Image Resize o recorte con Image ROI Select.

• La salida contiene motas o agujeros: Aplique Blur o Morphological Transformations a la máscara para eliminar pequeños defectos.

• No hay cambio visible después del enmascarado: Compruebe que la máscara contenga regiones no negras. Use Image Threshold para binarizar máscaras inciertas.

• Necesita inspeccionar resultados intermedios: Inserte Show Image tras los pasos de creación de la máscara para verificar su corrección antes de aplicarla.

📊 Evaluación

Al ejecutarse, este bloque genera la imagen Filtered. Use esta salida para visualizar, guardar o alimentar bloques de análisis posteriores, como detección o medición.