> 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/roi-processing/image-roi-polygon.md).

# Image ROI Polygon

Esta función permite dibujar un polígono directamente sobre una imagen para definir una región de interés (ROI) personalizada. Úsala para seleccionar formas irregulares, editar vértices de forma interactiva y obtener tanto la imagen recortada dentro del polígono como las coordenadas del polígono para procesamientos posteriores.

## 📥 Entradas

* `Image Any`\
  La imagen que se mostrará y anotará. Conecta aquí cualquier bloque que genere imagen para poder dibujar el polígono sobre una vista previa en vivo.

## 📤 Salidas

* `Image Any`\
  La imagen recortada correspondiente al área del polígono. Si no hay polígono definido, esta salida puede estar vacía.
* `Polygon`\
  Las coordenadas del polígono devueltas como una lista de contorno/forma adecuada para usar en otros bloques.

## 🕹️ Controles

* `Left Click`\
  Añade un vértice en la ubicación clicada.
* `Drag`\
  Haz clic y arrastra un vértice existente para reposicionarlo.
* `U`\
  Deshace el último vértice añadido.
* `C`\
  Borra todos los vértices y comienza de nuevo.
* `Overlay Preview`\
  Marcadores visuales y un relleno se muestran mientras editas para que veas el polígono, los vértices y el área seleccionada en tiempo real.

## ⚙️ Mecanismo de ejecución

* Conecta una fuente de imagen a la entrada `Image Any` y ejecuta el escenario una vez para poblar la vista previa.
* Dibuja el polígono haciendo clic para añadir vértices. La superposición se actualiza inmediatamente.
* Usa arrastrar y los atajos de teclado para refinar la forma.
* Cuando existe un polígono, el bloque genera en cada evaluación una imagen recortada (rectángulo delimitador ajustado al polígono) y la lista de coordenadas del polígono.

## ✨ Características

* Dibujo interactivo de polígonos con edición de vértices.
* Atajos para deshacer/limpiar para correcciones rápidas.
* Superposición visual con resaltado de vértices al pasar el cursor o arrastrar.
* Salidas tanto de la imagen recortada como de coordenadas precisas del polígono.
* Soporta ROIs no rectangulares y de múltiples puntos para objetos irregulares.

## 📝 Consejos de uso

* Dibuja al menos tres puntos para formar un polígono relleno; con menos puntos no obtendrás un recorte válido.
* Después de dibujar, ejecuta los bloques aguas abajo para procesar la imagen recortada o las coordenadas del polígono.
* Usa la función de arrastrar para ajustar con precisión las posiciones de los vértices y obtener mediciones exactas.

## 💡 Tips and Tricks

* Previsualiza imágenes más grandes conectando la salida a `Show Image` para poder dibujar con mayor precisión en un visor separado.
* Si necesitas múltiples ROIs en una sola imagen, usa `Image ROI Polygon Multi` para almacenar varias selecciones de polígonos y luego alimenta cada una a los bloques de procesamiento.
* Combínalo con `Get ROI` o `Image ROI Select` si prefieres recortes rectangulares primero y luego refinar con polígono para formas complejas.
* Usa `Apply Mask` después de este bloque para enmascarar la imagen original con el polígono y pasa esa imagen enmascarada a bloques de análisis.
* Alimenta la imagen recortada del polígono a bloques de detección o análisis como `Find Object`, `Object Detection`, `Mask Detection`, `Histogram On Line` o `Color Density Percentage` para centrar el procesamiento en el área seleccionada.
* Si la imagen es demasiado grande para dibujar cómodamente, añade `Image Resizer` o `Image Resize` antes de este bloque; recuerda que redimensionar cambia las coordenadas de píxel usadas por los bloques sensibles a geometría.
* Guarda las ROIs seleccionadas con `Image Logger`, `Image Write` o `Multi Image Write` para colectar conjuntos de datos o revisión posterior.

## 🛠️ Solución de problemas

* No se muestra ninguna imagen: asegúrate de que haya un bloque que produzca imagen conectado a `Image Any` y ejecuta una vez para poblar la vista previa.
* No se produce ROI: verifica que tengas al menos tres vértices; con menos puntos no se puede formar un polígono relleno.
* El polígono aparece desplazado después de redimensionar imágenes aguas arriba: dibuja a la resolución final o inserta `Image Resizer` de forma consistente en la tubería para que las coordenadas permanezcan alineadas.
* Necesitas coordenadas exactas para otros bloques: usa la salida `Polygon` (lista de coordenadas) y verifica con una vista previa a través de `Show Image` o vuelve a ejecutar después de los ajustes.