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

# Check Area

Este bloque de función te permite dibujar un área rectangular sobre una imagen y comprobar si una o más coordenadas de puntos caen dentro de esa área. Es ideal para verificaciones simples de región de interés y detecciones rápidas de presencia/ausencia dentro de un rectángulo seleccionado.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

`Image Any`\
Imagen de referencia usada como lienzo de coordenadas donde dibujarás el área rectangular.

`Position Coordinate(s)`\
Un punto o una lista de puntos para verificar respecto al área seleccionada. Proporciona coordenadas en píxeles (x, y).

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`Area Rectangle`\
El rectángulo seleccionado, expresado en coordenadas de píxeles de la imagen.

`Object In Area`\
Valor booleano que indica si algún punto proporcionado se encuentra dentro del rectángulo seleccionado.

`Detection Count`\
Número de puntos de entrada que se encontraron dentro del rectángulo seleccionado.

## 🕹️ Controles <a href="#controls" id="controls"></a>

`Image Preview`\
Haz clic y arrastra directamente sobre la vista previa para dibujar un área rectangular. La vista previa mostrará la superposición del rectángulo en tiempo real.

`Drag to Select`\
Usa el gesto de clic y arrastre para fijar las esquinas superior-izquierda e inferior-derecha del rectángulo. Volver a dibujar actualiza el área seleccionada inmediatamente.

`Overlay Display`\
Aparecen marcadores visuales en la imagen para el rectángulo seleccionado y para cualquier punto que caiga dentro de él.

## 🎨 Características <a href="#features" id="features"></a>

* Selección visual e interactiva de una sola región rectangular en la imagen de entrada.
* Soporta la verificación de una sola coordenada o de una lista de coordenadas.
* Marca los puntos detectados dentro del área con un marcador visible en la vista previa.
* Devuelve el rectángulo seleccionado y resultados simples (booleano/contador) para lógica posterior.

## 📊 Cómo funciona <a href="#evaluation" id="evaluation"></a>

* Proporciona una imagen válida al input `Image Any` para que la vista previa se active.
* Dibuja el rectángulo directamente en la vista previa usando clic y arrastre. La región seleccionada se interpreta en coordenadas de píxeles de la imagen.
* Alimenta puntos en `Position Coordinate(s)` (coordenada única o lista). Al evaluar, el bloque comprueba cada punto respecto al rectángulo seleccionado y devuelve el rectángulo, si hay puntos dentro y cuántos. La vista previa se actualiza para mostrar el rectángulo y los puntos contenidos.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta una fuente de imagen a `Image Any` para que aparezca la vista previa interactiva.
2. Haz clic y arrastra en la vista previa para dibujar el área que quieres vigilar.
3. Proporciona coordenadas de puntos a `Position Coordinate(s)` (por ejemplo, la salida de un bloque de detección).
4. Ejecuta el escenario; los resultados aparecerán como `Area Rectangle`, `Object In Area` y `Detection Count`. La vista previa mostrará marcadores para los puntos dentro del rectángulo.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Para obtener coordenadas de puntos desde detectores automáticos, conecta salidas de bloques como `Find Object` u `Object Detection` (o `Object Detection - Custom`) al input `Position Coordinate(s)`.
* Si necesitas múltiples áreas de recorte o formas ROI más flexibles, considera usar `Image ROI Select` o `Image ROI Polygon Multi` y luego alimentar los resultados a bloques de filtrado especializados.
* Usa `Draw Rectangle` o `Draw Point` para crear una salida visual combinada para informes o presentaciones tras la verificación.
* Para filtrado a nivel superior (por ejemplo, comprobar un rectángulo frente a muchos rectángulos detectados), combina con `Rectangles in Rectangle` para refinar resultados.
* Si las coordenadas provienen de detectores de pose o keypoints, prueba emparejar con `Pose Estimation` o `Hand Pose Estimation` para comprobar puntos clave específicos del cuerpo o la mano dentro del área.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* No aparece la vista previa: asegúrate de que una imagen válida esté conectada a `Image Any` y ejecuta al menos una vez para inicializar la vista previa.
* Coordenadas no detectadas como dentro: verifica que las coordenadas estén en formato de píxeles (x, y) que coincida con la resolución de la imagen, y no valores normalizados.
* Punto único vs lista: el bloque acepta una sola coordenada o una lista; si tu fuente suministra una estructura diferente, conviértela a un simple (x, y) o a una lista de pares (x, y) antes de conectar.
