> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/detections-shapes/shape-analysis/contour-to-image.md).
# 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.