> 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/point-polygon-test.md).

# Point Polygon Test

Esta función comprueba si una forma de prueba (contorno/puntos) está ubicada dentro de otra forma envolvente. Anota la imagen de entrada con marcadores visuales y devuelve un booleano que indica si todos los puntos de prueba están dentro del contorno envolvente.

## 📥 Entradas

`Input Image (Grayscale)`\
Una imagen en escala de grises usada como fondo para la visualización y el dibujo.

`Test Shape`\
Una forma (contorno o lista de puntos) que se quiere comprobar si está dentro.

`Enclosing Shape`\
Un contorno que actúa como la referencia envolvente.

## 📤 Salidas

`Output Image`\
Imagen anotada que muestra los puntos de prueba y el contorno envolvente. Los puntos dentro y fuera se marcan con colores distintos.

`Plot Image`\
Resultado booleano: True si todos los puntos de prueba están dentro del contorno envolvente; de lo contrario False.

## 🕹️ Controles

Este bloque no tiene controles interactivos adicionales. Se ejecuta usando las entradas proporcionadas.

## 🎨 Características

* Anotación visual del contorno de referencia y de cada punto de prueba sobre la imagen para verificación rápida.
* Indicador por punto (dentro vs fuera) usando marcadores con códigos de color.
* Devuelve un solo booleano que resume si la forma de prueba está completamente encerrada.

## ⚙️ Mecanismo de ejecución

* Al ejecutarse, el bloque lee las tres entradas listadas.
* Si alguna de las entradas de forma está vacía, el bloque devuelve la imagen de entrada sin cambios y no realiza la prueba.
* Si ambas formas están presentes, el bloque dibuja el contorno envolvente y evalúa cada punto de la forma de prueba respecto al contorno.
* Cada punto de prueba se dibuja en la imagen con un color que indica si está dentro o fuera. La salida booleana refleja si todos los puntos están dentro.

## 📝 Instrucciones de uso

1. Proporcione una imagen en escala de grises adecuada a `Input Image (Grayscale)` para la visualización.
2. Conecte el contorno o la lista de puntos que desea comprobar a `Test Shape`.
3. Conecte el contorno envolvente a `Enclosing Shape`.
4. Lea la imagen anotada desde `Output Image` y el resultado de inclusión desde `Plot Image`.

## 💡 Consejos y trucos

* Use `Find Contour` para extraer contornos de una imagen binaria y conecte su resultado a `Enclosing Shape` o `Test Shape`.
* Use `Approximate Contour` para simplificar contornos complejos antes de la prueba; esto acelera la evaluación y reduce falsos negativos.
* Recorte la zona de interés primero con `Image ROI` o `Image ROI Select` para centrar la prueba y reducir procesamiento.
* Para crear o inspeccionar la forma de prueba, use `Contour to Image` o dibuje puntos con `Draw Point` y use esa salida como `Test Shape`.
* Si la forma de prueba proviene de segmentación, pruebe con `Image Threshold` o `Fill Contour` antes para obtener contornos más limpios.

## 🛠️ Solución de problemas

* Si todos los puntos aparecen fuera inesperadamente, verifique que los sistemas de coordenadas coincidan (recortes o cambios de tamaño aguas arriba pueden desplazar coordenadas).
* Si el resultado no es concluyente, visualice contornos intermedios con `Show Image` para confirmar que las formas se han conectado correctamente.
* Si la extracción de contornos no produce formas útiles, preprocese la imagen con `Blur` o `Image Threshold` para mejorar la detección de bordes.