For the complete documentation index, see llms.txt. This page is also available as Markdown.

Grab Cut Algorithm

Este bloque de función separa los objetos del primer plano del fondo mediante un enfoque de segmentación interactiva. Ofrece tres modos de operación para que puedas proporcionar diferentes pistas (detección automática, un ROI rectangular o pequeñas máscaras de primer plano/fondo) que guíen la extracción.

📥 Entradas (sockets)

Image Any Proporciona la imagen color de origen que se desea segmentar.

ROI (opcional, como socket de entrada en modo ROI) Proporciona un rectángulo que indica la ubicación aproximada del objeto (formato: [(x1,y1),(x2,y2)]).

Foreground (opcional, como socket de entrada en modo Mask) Proporciona una máscara en escala de grises que indica posibles píxeles de primer plano.

Background (opcional, como socket de entrada en modo Mask) Proporciona una máscara en escala de grises que indica posibles píxeles de fondo.

📤 Salidas (sockets)

Image Any Imagen segmentada donde el fondo se elimina o enmascara — el objeto de primer plano permanece.

🕹️ Controles

Grabcut Method Selecciona entre los modos de extracción disponibles:

  • Automatic El bloque intenta localizar automáticamente el objeto principal y extraerlo.

  • ROI Usar cuando puedas proporcionar una región rectangular alrededor del objeto.

  • Mask Usar cuando puedas suministrar pequeñas máscaras de Foreground y Background como pistas.

🎨 Características

  • Varios modos de operación para elegir el enfoque más adecuado según la imagen y el flujo de trabajo.

  • Acepta tanto rectángulos aproximados como pistas detalladas de primer plano/fondo para una segmentación flexible.

  • Produce un recorte limpio apto para procesamiento posterior o exportación.

  • Funciona con imágenes en color (RGB/BGR) y devuelve un resultado en color con máscara.

⚙️ Mecanismo de ejecución (nivel alto)

  • El bloque lee el Grabcut Method seleccionado y espera que los sockets correspondientes estén conectados cuando sea necesario.

  • En modo Automatic encuentra una región inicial de primer plano automáticamente y la refina.

  • En modo ROI usa el rectángulo proporcionado como suposición inicial para la extracción.

  • En modo Mask utiliza las pequeñas máscaras de Foreground/Background proporcionadas para guiar la extracción.

  • El resultado es una imagen segmentada con el fondo eliminado o atenuado y se entrega a través del socket de salida Image Any.

📝 Instrucciones de uso

  1. Conecta un bloque que produzca imagen al input Image Any.

  2. Elige Grabcut Method:

    • Para resultados rápidos y automáticos selecciona Automatic.

    • Para extracción controlada suministra un rectángulo a ROI y selecciona ROI.

    • Para mayor precisión en escenas complejas proporciona pequeñas máscaras de Foreground y Background y selecciona Mask.

  3. Si usas ROI, proporciona un rectángulo en formato [(x1,y1),(x2,y2)] desde un bloque de selección ROI.

  4. Si usas Mask, suministra pequeñas máscaras en escala de grises marcando algunos píxeles de primer plano y fondo.

  5. Lee la salida segmentada desde el socket Image Any y continúa el procesamiento o guarda/exporta el resultado.

💡 Consejos y trucos

  • Si el sujeto es fácil de aislar por color, añade un prefiltro de color antes de este bloque. Bloques útiles: HSV Filter, RGB Mask o Image Threshold. Estos pueden ayudar a crear máscaras de Foreground/Background para el modo Mask.

  • Usa Image ROI Select para dibujar y proporcionar un rectángulo preciso cuando uses el modo ROI.

  • Para imágenes ruidosas intenta suavizar primero con Blur o Denoising para mejorar la detección de contornos en modo Automatic.

  • Combínalo con Morphological Transformations después de la segmentación para limpiar pequeños huecos o ruido en la máscara.

  • Para visualizar o guardar resultados, conecta Show Image para previsualizar y Image Write o Image Logger para persistir las salidas.

  • Para fondos complejos prueba ejecutar Background Subtractor o Background Removal (RMBG-1.4) / Background Removal (BiRefNet) antes en el flujo para crear una mejor máscara inicial para el bloque Grab Cut.

🛠️ Solución de problemas

  • Si el resultado pierde partes del objeto:

    • Prueba el modo ROI con un rectángulo un poco más grande.

    • O proporciona una pequeña máscara Foreground marcando algunos píxeles del objeto.

  • Si queda demasiado fondo:

    • Proporciona pistas en la máscara Background marcando regiones de fondo.

    • Prueba Morphological Transformations para eliminar fondo residual tras la segmentación.

  • Si no se detecta ningún objeto en Automatic:

    • Preprocesa con Contrast Optimization o Auto Contrast para aumentar la separación entre objeto y fondo.

    • Usa el modo ROI si la suposición automática falla.

  • Asegúrate de que las entradas de máscara sean imágenes en escala de grises y que las coordenadas de ROI estén dentro de los límites de la imagen.

Este bloque es ideal cuando necesitas una extracción fiable del primer plano antes de tareas de detección, medición o visualización.

Última actualización