Contour to Image

Esta función extrae una región rectangular de la imagen alrededor de un contorno dado. Proporciona una imagen de origen y un contorno (shape) y el bloque devuelve un recorte rectangular que contiene el contorno. Es útil cuando quieres aislar e inspeccionar un único objeto detectado dentro de una imagen más grande.

📥 Entradas

• Image — Imagen fuente que contiene el objeto a recortar. Puede ser a color o en escala de grises.

• Contour — Shape/contorno que describe el borde del objeto. Proporciona un contorno obtenido desde un bloque de detección de contornos o de procesamiento de formas.

📤 Salidas

• Image — Imagen rectangular recortada que contiene el área alrededor del contorno proporcionado.

🕹️ Controles

• No Controls — Este bloque no tiene widgets interactivos. Funciona recibiendo sus entradas y produciendo automáticamente la imagen recortada.

⚙️ Mecanismo de ejecución

Cuando el bloque se ejecuta, analiza el contorno proporcionado y determina un área rectangular que lo encierra. Esa área se extrae de la imagen fuente y se devuelve como salida del bloque. Si el contorno está rotado o es irregular, el bloque ajusta un rectángulo que contiene el contorno y devuelve un recorte rectangular para que puedas continuar el procesamiento más fácilmente.

✨ Características

• Extrae una imagen rectangular enfocada alrededor de un contorno para simplificar análisis posteriores.

• Funciona con contornos producidos por diversos bloques de detección y análisis de formas.

• Devuelve una salida de imagen lista para visualizar, reconocer o guardar.

📝 Cómo usar

1. Genera contornos a partir de tu imagen (por ejemplo, mediante umbralizado y detección de contornos).

2. Conecta la imagen fuente a la entrada Image y el contorno elegido a la entrada Contour.

3. El bloque entregará la imagen rectangular recortada en la salida Image. Úsala como entrada para otros bloques (por ejemplo, reconocimiento, OCR o guardado).

💡 Consejos y trucos

• Para generar contornos antes de este bloque, usa el bloque Find Contour.

• Si necesitas un polígono simplificado antes de recortar, prueba Approximate Contour para reducir el número de vértices.

• Para objetos rotados, compara resultados con Minimum Rotated Rectangle o Minimum Rectangle y elige la forma de encierre más adecuada para tu flujo.

• Previsualiza el recorte rápidamente con el bloque Show Image.

• Tras el recorte, puedes aplicar Image Resize para normalizar tamaños, o Auto Contrast / Denoising para preparar el recorte para tareas posteriores.

• Para guardar recortes automáticamente, conecta la salida de este bloque a Image Logger o Image Write.

🛠️ Solución de problemas

• Si la salida es inesperada o está vacía, verifica que la entrada Contour contenga un contorno válido (no None). Usa Find Contour o Approximate Contour para generar contornos válidos.

• Si el recorte aparece truncado, comprueba que las coordenadas del contorno estén dentro de los límites de la imagen fuente. Ajusta el preprocesado o la selección del contorno si es necesario.

• Si el objeto aparece rotado o distorsionado y necesitas otra perspectiva, prueba con Minimum Rotated Rectangle o sigue un flujo consciente de perspectiva (recortar y luego Auto Alignment / Perspective Transform) antes de continuar con el análisis.