> 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/hull-convex.md).

# Hull Convex

Este bloque de función calcula un contorno convexo envolvente a partir de un contorno proporcionado y devuelve resultados visuales y numéricos útiles para el análisis de formas.

## 📥 Entradas

`Image` La imagen fuente usada para visualización y mediciones.

`Contour` El contorno (forma) de entrada que se desea encerrar con un convex hull.

## 📤 Salidas

`Image` La imagen fuente anotada con el contorno original y su convex hull.

`Contour` El contorno del convex hull calculado, devuelto como una forma.

`Center` La posición del centroide del convex hull (x, y).

`Area` El área del convex hull.

## 🕹️ Controles

Este bloque no tiene controles interactivos. Se ejecuta automáticamente cuando se proporcionan las entradas.

## 🎯 Qué hace

* Calcula un convex hull envolvente para el contorno proporcionado.
* Dibuja tanto el contorno original como el convex hull sobre la imagen para facilitar la comparación visual.
* Calcula el área del hull y las coordenadas del centroide para mediciones o lógica posterior.
* Devuelve salida visual anotada y salidas estructuradas (forma/mediciones) para su procesamiento posterior.

## 📝 Instrucciones de uso

1. Proporcione la imagen original en la entrada `Image` para que el bloque genere un resultado visual anotado.
2. Conecte un contorno detectado a la entrada `Contour` para calcular su convex hull.
3. Use la salida `Image` para previsualizar el hull frente al contorno original; utilice `Contour`, `Center` y `Area` para mediciones, filtrado o informes.

## 📊 Evaluación

Al ejecutarse, el bloque examina el contorno proporcionado, produce la forma del convex hull, anota la imagen con ambas formas, calcula el centroide y el área del hull, y entrega estos cuatro resultados: imagen anotada, contorno del hull, punto central y área.

## 💡 Consejos y trucos

* Si aún no tiene un contorno, use el bloque `Find Contour` o `Find Object` para obtener contornos desde una imagen antes de alimentarlos a este bloque.
* Para simplificar contornos complejos antes de calcular el hull, considere `Approximate Contour` para reducir el número de puntos y mejorar el rendimiento.
* Use `Minimum Rectangle`, `Minimum Circle` o `Minimum Ellipse` después de este bloque si necesita formas envolventes alternativas o descriptores geométricos adicionales.
* Preprocese la imagen con `Image Threshold`, `Image Adaptive Threshold` o `Blur` para obtener contornos más limpios y un cálculo de hull más confiable.
* Recorte o enfoque el análisis usando `Image ROI`, `Image ROI Select` o `Image ROI Polygon` para que la extracción de contornos y el cálculo del hull apunten al área de interés.
* Visualice resultados en una ventana más grande con `Show Image` y guarde cuadros importantes con `Image Logger` o `Image Write` para documentación o revisión fuera de línea.

## 🛠️ Solución de problemas

* Si la salida `Contour` está vacía o el valor de `Area` es cero: asegúrese de que la entrada `Contour` sea válida y contenga suficientes puntos. Use bloques que generen contornos (`Find Contour`, `Find Object`) y verifique sus salidas.
* Si las anotaciones se ven fuera de lugar después del escalado de la imagen: asegúrese de usar las mismas dimensiones de imagen en todo el flujo (use `Image Resize` o `Image Resizer` de forma consistente).
* Si formas indeseadas del fondo generan hulls grandes: pruebe con preprocesamiento (umbralizado, desenfoque) y use bloques ROI para centrarse en el objeto de interés.