> 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/roi-processing/check-area-polygon.md).

# Check Area (Polygon)

Ce bloc fonctionnel vous permet de dessiner un polygone directement sur une image et de vérifier si des coordonnées de position données se trouvent à l'intérieur de ce polygone. Utilisez-le pour mettre en évidence une région d'intérêt (ROI), compter ou marquer les objets à l'intérieur de la zone, et exporter le polygone comme une forme pour un traitement en aval.

## 📥 Entrées (sockets)

`Input Image (Binary Image)`\
Il s'agit de l'image sur laquelle vous dessinez le polygone et recevez un retour visuel.

`Position Coordinate List`\
Une liste de coordonnées de points (x, y) à tester par rapport au polygone dessiné. Plusieurs positions sont prises en charge.

## 📤 Sorties (sockets)

`Output Image`\
L'image avec la zone du polygone mise en évidence et les positions détectées marquées.

`Polygon Coordinates`\
Les sommets du polygone en tant que forme réutilisable par d'autres blocs.

`Object In Area`\
Booléen indiquant si une ou plusieurs positions fournies se situent à l'intérieur du polygone.

`Detected Positions`\
La liste des positions qui sont détectées comme étant à l'intérieur du polygone.

## 🕹️ Contrôles (widgets & interactions)

`Image Canvas`\
Cliquez sur l'image pour ajouter des points du polygone. Le polygone dessiné s'affiche en temps réel par-dessus l'image.

`U`\
Appuyez sur cette touche pour annuler le dernier point ajouté.

`C`\
Appuyez sur cette touche pour effacer tous les points du polygone et recommencer.

`Select Area`\
Utilisez l'interaction de dessin pour créer la zone polygonale souhaitée.

## 🎨 Fonctionnalités

* Dessin visuel de polygone sur l'image d'entrée avec aperçu persistant.
* Mise en évidence immédiate de la zone sélectionnée via un overlay translucide.
* Marquage des positions détectées à l'intérieur du polygone avec des repères clairs.
* Renvoie les coordonnées du polygone en tant que forme réutilisable pour d'autres blocs de traitement.
* Prend en charge plusieurs positions d'entrée et indique lesquelles se trouvent dans la zone dessinée.

## ⚙️ Mode de fonctionnement

* L'image fournie au socket `Input Image (Binary Image)` est affichée sur le canvas.
* Vous ajoutez interactivement les sommets du polygone en cliquant sur le canvas. Chaque clic devient un sommet.
* Le polygone tracé est mis en évidence visuellement sur l'image.
* Lorsque des coordonnées de position sont fournies au socket `Position Coordinate List`, le bloc vérifie chaque point et marque ceux qui sont à l'intérieur du polygone.
* Les résultats (image avec zone surlignée, coordonnées du polygone, indicateur booléen et positions détectées) sont fournis en sortie pour que d'autres blocs puissent les utiliser.

## 📝 Instructions d'utilisation

1. Connectez une image à `Input Image (Binary Image)` pour activer le canvas de dessin.
2. Cliquez sur l'image pour ajouter les sommets du polygone dans l'ordre horaire ou antihoraire.
3. Utilisez `U` pour annuler un point ou `C` pour effacer et redessiner le polygone.
4. Fournissez une liste de coordonnées à `Position Coordinate List` pour vérifier quelles positions se trouvent à l'intérieur du polygone.
5. Utilisez la sortie `Polygon Coordinates` pour transmettre la zone dessinée à d'autres blocs pour un traitement ultérieur.

## 💡 Astuces et bonnes pratiques

* Pour fournir automatiquement les points à tester, utilisez en amont `Find Object` ou `Object Detection` (ou `Object Detection - Custom`) afin d'alimenter `Position Coordinate List` avec les centres des objets détectés.
* Visualisez les résultats dans une fenêtre plus grande en connectant `Output Image` à `Show Image` pour un aperçu agrandi.
* Sauvegardez ou enregistrez les images mises en évidence en connectant `Output Image` à `Image Logger` ou `Image Write`.
* Pour créer plusieurs zones ROI, combinez ce bloc avec `Image ROI Polygon Multi` afin de gérer plusieurs polygones et de transmettre ensuite les coordonnées souhaitées.
* Si vous préférez marquer les détections par des rectangles plutôt que des points, utilisez `Draw Rectangle` ou `Draw Point` en aval avec les coordonnées fournies par ce bloc.
* Pour des flux de suivi (tracking), alimentez `Object_Detection_Tracker` avec les détections issues de `Object Detection` et utilisez ce bloc pour vérifier les événements d'entrée/sortie dans une zone polygonale.

## 🛠️ Dépannage

* Si les clics n'apparaissent pas, vérifiez qu'une image est connectée au socket `Input Image (Binary Image)` et que le canvas est visible.
* Si des points sont signalés à l'extérieur de la zone de manière inattendue, vérifiez que le format des coordonnées est bien (x, y) et que les coordonnées partagent le même repère que l'image affichée.
* Si le polygone disparaît entre les sessions, redessinez-le ou stockez la sortie `Polygon Coordinates` dans un bloc de stockage persistant (par ex. via des sorties fichier ou de journalisation) et réappliquez-le au besoin.