> 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/check-area-polygon.md).
# Check Area (Polygon)
Esta función permite dibujar un polígono directamente sobre una imagen y comprobar si coordenadas de posición dadas caen dentro de ese polígono. Úsela para resaltar una región de interés (ROI), contar o marcar objetos dentro del área y exportar el polígono como una forma para procesamiento posterior.
## 📥 Inputs (sockets)
`Input Image (Binary Image)` Esta es la imagen sobre la que dibuja el polígono y recibe la retroalimentación visual.
`Position Coordinate List` Una lista de coordenadas de puntos (x, y) para verificar con respecto al polígono dibujado. Se admiten múltiples posiciones.
## 📤 Outputs (sockets)
`Output Image` La imagen con el área poligonal resaltada y las posiciones detectadas marcadas.
`Polygon Coordinates` Los vértices del polígono como una shape que puede ser utilizada por otros bloques.
`Object In Area` Booleano que indica si alguna de las posiciones suministradas se encuentra dentro del polígono.
`Detected Positions` La lista de posiciones que se han encontrado dentro del polígono.
## 🕹️ Controls (widgets & interactions)
`Image Canvas` Haga clic sobre la imagen para añadir puntos del polígono. El polígono dibujado se muestra en tiempo real sobre la imagen.
`U` Presione esta tecla para deshacer el último punto añadido.
`C` Presione esta tecla para borrar todos los puntos del polígono y empezar de nuevo.
`Select Area` Use la interacción de dibujo para crear la región poligonal deseada.
## 🎨 Features
* Dibujo visual de polígonos sobre la imagen de entrada con vista previa persistente.
* Resaltado visual inmediato del área seleccionada con una superposición translúcida.
* Marcado de posiciones detectadas dentro del polígono con marcadores claros.
* Devuelve `Polygon Coordinates` como una shape reutilizable para otros bloques de procesamiento.
* Soporta múltiples posiciones de entrada y reporta cuáles están dentro del área dibujada.
## ⚙️ Running mechanism
* La imagen suministrada al socket `Input Image (Binary Image)` se muestra en el canvas.
* Añade interactivamente vértices del polígono haciendo clic en el canvas. Cada clic se convierte en un vértice.
* El polígono dibujado se resalta visualmente sobre la imagen.
* Cuando se proporcionan coordenadas a `Position Coordinate List`, el bloque comprueba cada punto y marca los que están dentro del polígono.
* Los resultados (imagen resaltada, `Polygon Coordinates`, la bandera booleana y las `Detected Positions`) se emiten para que otros bloques puedan consumirlos.
## 📝 Usage instructions
1. Conecte una imagen a `Input Image (Binary Image)` para habilitar el lienzo de dibujo.
2. Haga clic en la imagen para añadir vértices del polígono en orden horario o antihorario.
3. Use la tecla `U` para deshacer un punto o `C` para borrar y redibujar el polígono.
4. Envíe una lista de coordenadas a `Position Coordinate List` para comprobar qué puntos están dentro del polígono.
5. Use la salida `Polygon Coordinates` para pasar el área dibujada a otros bloques para procesamiento adicional.
## 💡 Tips and Tricks
* Para proporcionar los puntos a comprobar automáticamente, use `Find Object` o `Object Detection` (o `Object Detection - Custom`) aguas arriba para que los centros de los objetos detectados se alimenten a la entrada `Position Coordinate List`.
* Visualice los resultados en una ventana más grande conectando `Output Image` a `Show Image` para una vista ampliada.
* Guarde o registre las imágenes resaltadas conectando `Output Image` a `Image Logger` o `Image Write`.
* Para crear múltiples áreas ROI, combine este bloque con `Image ROI Polygon Multi` para gestionar varios polígonos y pasar las coordenadas del polígono seleccionado a continuación.
* Si desea marcar las detecciones con rectángulos en lugar de puntos, use `Draw Rectangle` o `Draw Point` aguas abajo con las coordenadas proporcionadas por este bloque.
* Para flujos de seguimiento, alimente detecciones desde `Object Detection` a `Object_Detection_Tracker` y use este bloque para comprobar eventos de entrada/salida en un área poligonal.
## 🛠️ Troubleshooting
* Si los clics no aparecen, asegúrese de que una imagen esté conectada al socket `Input Image (Binary Image)` y de que el canvas sea visible.
* Si los puntos se reportan fuera inesperadamente, verifique que el formato de las coordenadas coincida (x, y) y que las coordenadas estén en el mismo sistema de referencia que la imagen mostrada.
* Si el polígono desaparece entre sesiones, vuelva a dibujarlo o almacene la salida del polígono en un bloque de almacenamiento persistente (por ejemplo, use salidas con bloques de archivo o logging) y replique cuando sea necesario.