Shape Detector

Este bloque de función encuentra una forma distintiva en una imagen a color mediante filtrado, umbralización y análisis de contornos. Devuelve un resultado visual y descriptores numéricos de la forma que pueden usarse en bloques posteriores.

📥 Entradas

Image Este conector de entrada acepta una imagen a color para analizar.

📤 Salidas

Filtered Image Conector de salida que proporciona la imagen binaria o filtrada usada para la extracción de contornos (retroalimentación visual del preprocesado).

Contoured Image Conector de salida que proporciona la imagen original con el contorno detectado dibujado.

Shape Image Conector de salida que proporciona la visualización recortada o separada de la forma.

Border Coordinate Conector de salida que proporciona la(s) coordenada(s) del contorno que forman el borde detectado.

Shape Width Conector de salida que proporciona el ancho de la forma detectada.

Shape Height Conector de salida que proporciona la altura de la forma detectada.

Shape Position Conector de salida que proporciona la posición del centro de la forma detectada.

Shape Rotation Conector de salida que proporciona el ángulo de rotación de la forma detectada.

🕹️ Controles

Blur coefficient Control tipo slider para ajustar la intensidad del desenfoque mediano antes de la umbralización. Úselo para reducir ruido preservando bordes.

Clear spots parameter Control tipo slider para configurar el tamaño del cierre morfológico. Úselo para eliminar pequeños huecos o unir partes de un objeto.

Auto threshold ? Checkbox para activar la umbralización automática (Otsu). Cuando está activado, el rango de umbral manual queda deshabilitado.

Threshold range Control tipo slider de doble extremo para establecer los valores manuales de umbral bajo/alto. Activo cuando Auto threshold ? está desmarcado.

Shape area range % Slider de doble extremo para limitar los contornos detectados por área relativa (porcentaje de la imagen). Úselo para ignorar objetos muy pequeños o muy grandes.

⚙️ Mecanismo de ejecución

• Cuando se proporciona una imagen en el conector Image, el bloque aplica el desenfoque seleccionado, la umbralización (automática o manual) y el cierre morfológico.

• Se extraen contornos de la imagen filtrada. El bloque selecciona contornos que entran en el Shape area range % configurado y devuelve el contorno válido más grande junto con las salidas relacionadas.

• Las salidas visuales muestran la imagen filtrada y el contorno detectado dibujado sobre la imagen original para verificar los resultados en la interfaz.

• Al activar/desactivar Auto threshold ?, el control Threshold range manual se habilita o deshabilita instantáneamente para facilitar la experimentación.

✨ Características

• Salidas visuales de depuración tanto para la imagen umbralizada como para la superposición de contornos.

• Preprocesado flexible: parámetros de Blur coefficient y Clear spots parameter para desenfoque mediano y cierre morfológico.

• Filtrado por área para evitar contornos falsos causados por ruido o bordes.

• Produce salidas visuales y descriptores numéricos (tamaño, posición, rotación) para lógica posterior o registro.

📝 Instrucciones de uso

1. Alimente una imagen a color en el conector Image.

2. Empiece con un Blur coefficient moderado y un Clear spots parameter pequeño.

3. Pruebe primero con Auto threshold ?. Si los resultados son ruidosos, desactívelo y ajuste Threshold range manualmente.

4. Ajuste Shape area range % para que el objeto deseado esté dentro del intervalo de área permitido.

5. Inspeccione Filtered Image y Contoured Image para confirmar la detección. Use bloques posteriores para actuar sobre Shape Position o Shape Rotation.

💡 Consejos y trucos

• Si la imagen tiene ruido de color o variaciones de iluminación, añada una cadena de preprocesado antes de este bloque con HSV Filter o Adjust Colors para mejorar la separación entre objeto y fondo.

• Use Blur o Denoising aguas arriba para reducir salpicaduras antes de la umbralización y obtener contornos más estables.

• Si necesita analizar solo una subregión, recorte primero con Image ROI Select o Image ROI y alimente la imagen recortada a este bloque.

• Para convertir una escena colorida y ruidosa en una entrada binaria más clara, combine con Image Adaptive Threshold o Image Threshold antes de este bloque.

• Para procesamiento geométrico o extracción de características adicional, conecte las salidas a bloques relacionados como Approximate Contour, Minimum Rectangle, Minimum Rotated Rectangle o Translate Shape.

• Visualice resultados en vivo usando el bloque Show Image y guarde ejemplos o registros con Image Logger o Image Write para inspección posterior.

🛠️ Solución de problemas

• No se encuentra contorno: aumente el límite superior de Shape area range % o reduzca el mínimo; compruebe Filtered Image para confirmar que el objeto aparece tras la umbralización.

• Demasiados contornos pequeños: aumente Clear spots parameter (cierre morfológico) o apriete el área mínima en Shape area range %.

• El objeto se divide en varios contornos: reduzca el desenfoque o disminuya el cierre morfológico, o recorte la región con Image ROI Select para aislar el objeto.

• La umbralización no funciona: pruebe activando Auto threshold ? para que el bloque seleccione un umbral adecuado automáticamente y luego ajuste Threshold range manual si es necesario.