> 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-multi.md).

# Image ROI Polygon Multi

Esta función permite dibujar, editar y guardar múltiples regiones poligonales de interés (ROIs) directamente sobre una imagen. Úsala para marcar formas arbitrarias, extraer recortes enmascarados y exportar las coordenadas de los polígonos para procesamiento posterior — todo con interacciones sencillas de ratón y teclado.

## 📥 Entradas

`Image Any`\
Proporciona la imagen que deseas anotar. Una vez que la imagen esté conectada y el bloque se ejecute, la imagen se convierte en el lienzo para dibujar polígonos.

## 📤 Salidas

`Highlighted Image`\
Devuelve la imagen original anotada con los polígonos (guardados y el actual) y marcadores visuales.

`Polygon Images`\
Devuelve una lista de imágenes recortadas y enmascaradas — una por cada polígono guardado — preservando los píxeles originales dentro de cada polígono.

`Polygons`\
Devuelve una lista de polígonos como listas de coordenadas (contornos) que pueden ser usadas por otros bloques de función.

## 🕹️ Controles

`Draw Polygon Canvas`\
Área interactiva de la imagen donde dibujas polígonos con clics izquierdos del ratón.

`Press C`\
Borra el polígono actual (o elimina el último polígono guardado si no hay polígono actual).

`Press U`\
Deshace el último punto del polígono actual. Si no hay polígono actual, esto devuelve el último polígono guardado para editarlo.

`Press S`\
Guarda el polígono actual (requiere al menos 3 puntos). Los polígonos guardados pasan a formar parte de las listas de salida.

Interacciones del ratón: clic izquierdo para añadir un punto; arrastrar un vértice para moverlo; al pasar el cursor sobre vértices se resaltan y se habilita la edición. El icono del cursor cambia para indicar modo de creación o edición de vértices.

## 🎨 Características

* Edición persistente de múltiples polígonos: crea varios polígonos y alterna entre el polígono actual y los guardados.
* Superposiciones visuales: distintos colores indican polígonos guardados, el que se está editando, vértices resaltados y puntos activos.
* Recortes ROI exportables: devuelve imágenes recortadas y enmascaradas para cada polígono guardado, aptas para procesado posterior.
* Exportación de coordenadas: devuelve las coordenadas de los vértices como listas de contorno estándar para uso posterior.
* Controles de teclado simples para edición rápida (C, U, S) y dibujo intuitivo con el ratón.

## ⚙️ Cómo se ejecuta

* Cuando se suministra una imagen al `Image Any` y se evalúa el bloque, la imagen aparece en el lienzo interactivo.
* Dibuja puntos en el lienzo para formar un polígono. Las superposiciones visuales se actualizan en tiempo real.
* Guardar un polígono lo añade a la lista interna; el bloque produce salidas actualizadas en cada ejecución: la imagen anotada, una lista de imágenes enmascaradas/recortadas por polígono y una lista de coordenadas de polígonos.
* Editar o arrastrar vértices actualiza las salidas en la siguiente evaluación.

## 📝 Instrucciones de uso

1. Conecta una fuente de imagen a la entrada `Image Any` (por ejemplo: `Camera USB`, `Load Image` o `Stream Reader`).
2. Haz clic en el lienzo para añadir vértices del polígono. Añade al menos tres puntos para formar un polígono.
3. Usa `Press S` para guardar el polígono actual. Los polígonos guardados se incluirán en las salidas.
4. Para corregir un punto, pasa el cursor hasta que el vértice se resalte y arrástralo a la nueva posición.
5. Usa `Press U` para deshacer el último punto, o `Press C` para limpiar el polígono actual.
6. Ejecuta el bloque para obtener las salidas `Highlighted Image`, `Polygon Images` y `Polygons`, y conéctalas a otros bloques según necesites.

## 💡 Tips y trucos

* Preselecciona áreas de interés usando `Image ROI Select` o `Image ROI` cuando solo necesites enfocarte en una sub-región antes de dibujar polígonos.
* Usa `Apply Mask` después de este bloque para combinar máscaras poligonales con otra lógica de enmascarado (por ejemplo, para eliminar fondo o combinar múltiples máscaras).
* Alimenta `Polygon Images` a bloques de detección o análisis como `Find Object`, `Object Detection` o `Mask Detection` para ejecutar la detección solo dentro de las regiones seleccionadas.
* Guarda ejemplos de ROIs recortadas usando `Image Logger` o `Image Write` para construir un conjunto de referencia a partir de polígonos seleccionados.
* Si necesitas múltiples superposiciones de polígonos lado a lado, usa `Image Concatenate` o `Collage Images` con la salida `Polygon Images`.
* Para preprocesado antes de dibujar (por ejemplo, para crear una máscara binaria a trazar), usa `Blur`, `Image Threshold` o `HSV Filter` río arriba para simplificar los contornos.

## 🛠️ Solución de problemas

* Al hacer clic en el lienzo no ocurre nada: asegúrate de que una imagen esté conectada a `Image Any` y ejecuta el bloque al menos una vez para inicializar el lienzo.
* No se puede guardar el polígono: verifica que tu polígono actual tenga al menos tres puntos antes de presionar `Press S`.
* Salidas de polígonos vacías: comprueba que los polígonos hayan sido guardados (usa `Press S`); los polígonos no guardados no se incluyen en `Polygon Images` ni en `Polygons`.
* El recorte del polígono aparece vacío: asegúrate de que el polígono esté dentro de los límites de la imagen y de que la imagen tenga datos de píxeles válidos. Si es necesario, preprocesa la imagen con `Normalize Image` o `Denoising` antes de dibujar.