> 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/french/function-blocks/blocks-reference/detections-shapes/shape-analysis/hull-convex.md).

# Hull Convex

Ce bloc fonction calcule un contour convexe englobant autour d'un contour donné et renvoie des résultats visuels et numériques utiles pour l'analyse de forme.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Image` L'image source utilisée pour la visualisation et les mesures.

`Contour` Le contour (forme) d'entrée à envelopper avec un hull convexe.

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

`Image` L'image source annotée avec le contour original et son hull convexe.

`Contour` Le contour du hull convexe calculé, retourné en tant que forme.

`Center` La position du centroïde du hull convexe (x, y).

`Area` L'aire du hull convexe.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

Ce bloc fonction n'a pas de contrôles interactifs. Il s'exécute automatiquement lorsqu'il reçoit des entrées.

## 🎯 Ce qu'il fait <a href="#features" id="features"></a>

* Calcule un hull convexe englobant pour le contour fourni.
* Dessine à la fois le contour original et le hull convexe sur l'image pour une comparaison visuelle claire.
* Calcule l'aire du hull et les coordonnées de son centroïde pour des mesures ou une logique en aval.
* Retourne à la fois une sortie visuelle annotée et des sorties structurées (forme/mesures) pour un traitement ultérieur.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Fournissez l'image originale sur l'entrée `Image` afin que le bloc puisse produire un résultat visuel annoté.
2. Fournissez un contour détecté sur l'entrée `Contour` pour calculer son hull convexe.
3. Utilisez la `Image` retournée pour prévisualiser le hull par rapport au contour original, et utilisez `Contour`, `Center` et `Area` pour des mesures, du filtrage ou des rapports.

## 📊 Évaluation <a href="#evaluation" id="evaluation"></a>

Lors de l'exécution, le bloc examine le contour fourni, produit une forme de hull convexe, annote l'image avec les deux formes, calcule le centroïde et l'aire du hull, et renvoie ces quatre résultats : image annotée, contour du hull, point central et aire.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Si vous n'avez pas encore de contour, utilisez le bloc `Find Contour` ou `Find Object` pour obtenir des contours à partir d'une image avant de les fournir à ce bloc.
* Pour simplifier des contours complexes avant le calcul du hull, pensez à `Approximate Contour` pour réduire le nombre de points et améliorer les performances.
* Utilisez `Minimum Rectangle`, `Minimum Circle` ou `Minimum Ellipse` après ce bloc si vous avez besoin de formes englobantes alternatives ou de descripteurs géométriques supplémentaires.
* Prétraitez l'image avec `Image Threshold`, `Image Adaptive Threshold` ou `Blur` pour obtenir des contours plus propres et une computation du hull plus fiable.
* Recadrez ou concentrez l'analyse avec `Image ROI`, `Image ROI Select` ou `Image ROI Polygon` afin que l'extraction du contour et le calcul du hull ciblent la zone d'intérêt.
* Visualisez les résultats dans une fenêtre plus grande avec `Show Image` et enregistrez les images importantes avec `Image Logger` ou `Image Write` pour la documentation ou la revue hors ligne.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si la sortie `Contour` est vide ou que la `Area` vaut zéro : assurez-vous que l'entrée `Contour` est valide et contient suffisamment de points. Utilisez des blocs producteur de contours (`Find Contour`, `Find Object`) et vérifiez leurs sorties.
* Si les annotations semblent déplacées après un redimensionnement de l'image : assurez-vous d'utiliser les mêmes dimensions d'image dans tout le pipeline (utilisez `Image Resize` ou `Image Resizer` de manière cohérente).
* Si des formes d'arrière-plan indésirables produisent de grands hulls : essayez le prétraitement (seuillage, flou) et utilisez les blocs ROI pour vous concentrer sur l'objet d'intérêt.