> 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/image-roi-polygon.md).

# Image ROI Polygon

Ce bloc fonction permet de dessiner un polygone directement sur une image pour définir une région d'intérêt (ROI) personnalisée. Utilisez-le pour sélectionner des formes irrégulières, éditer les sommets de façon interactive, et produire à la fois l'image recadrée à l'intérieur du polygone et les coordonnées du polygone pour un traitement ultérieur.

## 📥 Entrées

* `Image Any`\
  L'image à afficher et annoter. Connectez ici n'importe quel bloc produisant une image pour pouvoir dessiner le polygone sur un aperçu en direct.

## 📤 Sorties

* `Image Any`\
  L'image recadrée correspondant à la zone du polygone. Si aucun polygone n'est défini, cette sortie peut être vide.
* `Polygon`\
  Les coordonnées du polygone renvoyées sous forme de liste de contours/shapes adaptées à d'autres blocs.

## 🕹️ Contrôles

* `Left Click`\
  Ajouter un sommet à l'emplacement cliqué.
* `Drag`\
  Cliquer et glisser un sommet existant pour le repositionner.
* `U`\
  Annuler le dernier sommet ajouté.
* `C`\
  Effacer tous les sommets et recommencer.
* `Overlay Preview`\
  Des marqueurs visuels et un remplissage sont affichés pendant l'édition pour voir le polygone, les sommets et la zone sélectionnée en temps réel.

## ⚙️ Mécanisme d'exécution

* Connectez une source d'image à l'entrée `Image Any` et exécutez le scénario une fois pour remplir l'aperçu.
* Dessinez le polygone en cliquant pour ajouter des sommets. La superposition se met à jour immédiatement.
* Utilisez les fonctions de glisser et les raccourcis clavier pour affiner la forme.
* Lorsqu'un polygone est présent, le bloc produit à chaque évaluation une image recadrée (rectangle englobant serré du polygone) et la liste des coordonnées du polygone.

## ✨ Fonctionnalités

* Dessin interactif de polygones avec édition des sommets.
* Raccourcis annuler/effacer pour des corrections rapides.
* Superposition visuelle avec mise en évidence des sommets au survol ou lors du glissement.
* Production à la fois d'une image recadrée et de coordonnées précises du polygone.
* Prise en charge des ROI non rectangulaires et à plusieurs points pour des objets irréguliers.

## 📝 Conseils d'utilisation

* Dessinez au moins trois points pour former un polygone rempli ; moins de points ne donnera pas de recadrage ROI valide.
* Après le dessin, exécutez les blocs en aval pour traiter l'image recadrée ou les coordonnées du polygone.
* Utilisez la fonction de glisser pour affiner la position des sommets pour des mesures précises.

## 💡 Astuces

* Prévisualisez des images plus grandes en connectant la sortie à `Show Image` pour dessiner plus précisément dans un visualiseur séparé.
* Si vous avez besoin de multiples ROI dans une image, utilisez `Image ROI Polygon Multi` pour stocker plusieurs sélections de polygones puis alimentez chacune vers des blocs de traitement.
* Combinez avec `Get ROI` ou `Image ROI Select` si vous préférez d'abord des recadrages rectangulaires, puis affinez avec le polygone pour des formes complexes.
* Utilisez `Apply Mask` après ce bloc pour masquer l'image originale avec le polygone et envoyez cette image masquée vers des blocs d'analyse.
* Alimentez l'image recadrée du polygone vers des blocs de détection ou d'analyse tels que `Find Object`, `Object Detection`, `Mask Detection`, `Histogram On Line` ou `Color Density Percentage` pour concentrer le traitement sur la zone sélectionnée.
* Si l'image est trop grande pour dessiner confortablement, ajoutez `Image Resizer` ou `Image Resize` avant ce bloc ; souvenez-vous que le redimensionnement modifie les coordonnées en pixels utilisées par les blocs sensibles à la géométrie en aval.
* Sauvegardez les ROI sélectionnées avec `Image Logger`, `Image Write` ou `Multi Image Write` pour la constitution d'un jeu de données ou une revue ultérieure.

## 🛠️ Résolution des problèmes

* Aucune image affichée : assurez-vous qu'un bloc produisant une image est connecté à `Image Any` et exécutez une fois pour remplir l'aperçu.
* ROI non produite : vérifiez que vous avez au moins trois sommets ; moins de points ne peuvent pas former un polygone rempli.
* Le polygone semble déplacé après redimensionnement des images en amont : dessinez à la résolution finale ou insérez `Image Resizer` de façon cohérente dans le pipeline pour que les coordonnées restent alignées.
* Besoin de coordonnées exactes pour d'autres blocs : utilisez la sortie `Polygon` (liste de coordonnées) et vérifiez avec un aperçu via `Show Image` ou réexécutez après ajustements.