> 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-multi.md).

# Image ROI Polygon Multi

Ce bloc fonctionnel vous permet de dessiner, modifier et sauvegarder plusieurs régions polygonales d'intérêt (ROIs) directement sur une image. Utilisez-le pour marquer des formes arbitraires, extraire des découpes masquées et exporter les coordonnées des polygones pour un traitement ultérieur — le tout avec des interactions simples souris/clavier.

## 📥 Entrées

`Image Any`\
Fournissez l'image que vous souhaitez annoter. Une fois qu'une image est connectée et que le bloc est exécuté, l'image devient la toile sur laquelle dessiner les polygones.

## 📤 Sorties

`Highlighted Image`\
Renvoie l'image d'origine annotée avec les polygones (sauvegardés et en cours) et des repères visuels.

`Polygon Images`\
Renvoie une liste d'images recadrées et masquées — une par polygone sauvegardé — en préservant les pixels originaux à l'intérieur de chaque polygone.

`Polygons`\
Renvoie une liste de formes polygonales sous forme de listes de coordonnées (contours) pouvant être utilisées par d'autres blocs fonctionnels.

## 🕹️ Contrôles

`Draw Polygon Canvas`\
Zone interactive de l'image où vous dessinez les polygones avec des clics gauche de souris.

`Press C`\
Efface le polygone courant (ou supprime le dernier polygone sauvegardé si aucun polygone en cours).

`Press U`\
Annule le dernier point du polygone courant. S'il n'y a pas de polygone courant, cela remet le dernier polygone sauvegardé en mode édition.

`Press S`\
Sauvegarde le polygone courant (requiert au moins 3 points). Les polygones sauvegardés sont ajoutés aux listes de sortie.

Interactions souris : clic gauche pour ajouter un point ; cliquer-glisser sur un sommet pour le déplacer ; survoler un sommet le met en surbrillance et permet de l'éditer. L'icône du curseur change pour indiquer le mode création ou édition de sommet.

## 🎨 Fonctionnalités

* Édition persistante multi-polygone : créez plusieurs polygones et basculez entre polygone courant et polygones sauvegardés.
* Superpositions visuelles : couleurs distinctes pour les polygones sauvegardés, le polygone en cours d'édition, les sommets survolés et les points actifs.
* Découpes ROI exportables : renvoie des images masquées et recadrées pour chaque polygone sauvegardé, prêtes pour un traitement ultérieur.
* Export des coordonnées : fournit les coordonnées des sommets comme listes de contours standard pour réutilisation.
* Contrôles clavier simples pour une édition rapide (C, U, S) et dessin intuitif guidé par la souris.

## ⚙️ Mode de fonctionnement

* Lorsqu'une image est fournie à l'entrée et que le bloc est évalué, l'image apparaît dans la toile interactive.
* Dessinez des points sur la toile pour former un polygone. Les superpositions visuelles se mettent à jour en temps réel.
* Sauvegarder un polygone l'ajoute à la liste interne ; le bloc produit des sorties mises à jour à chaque exécution : l'image annotée, la liste d'images masquées/recadrées et la liste des coordonnées de polygones.
* L'édition et le déplacement des sommets mettent à jour les sorties lors de la prochaine évaluation.

## 📝 Instructions d'utilisation

1. Connectez une source d'image à l'entrée `Image Any` (par exemple : `Camera USB`, `Load Image` ou `Stream Reader`).
2. Cliquez sur la toile pour ajouter des sommets au polygone. Ajoutez au moins trois points pour former un polygone.
3. Utilisez `Press S` pour sauvegarder le polygone courant. Les polygones sauvegardés seront inclus dans les sorties.
4. Pour corriger un point, survolez-le jusqu'à ce qu'il soit mis en surbrillance puis glissez-le à la nouvelle position.
5. Utilisez `Press U` pour annuler le dernier point, ou `Press C` pour effacer le polygone courant.
6. Exécutez le bloc pour obtenir les sorties `Highlighted Image`, `Polygon Images` et `Polygons` et les transmettre aux autres blocs.

## 💡 Astuces

* Pré-sélectionnez des zones d'intérêt avec `Image ROI Select` ou `Image ROI` si vous souhaitez vous concentrer sur un sous-région avant de dessiner.
* Utilisez `Apply Mask` après ce bloc pour combiner les masques polygonaux avec d'autres logiques de masquage (par exemple pour supprimer l'arrière-plan ou combiner plusieurs masques).
* Injectez `Polygon Images` dans des blocs d'analyse comme `Find Object`, `Object Detection` ou `Mask Detection` afin d'effectuer des détections uniquement à l'intérieur des régions sélectionnées.
* Sauvegardez des exemples de ROI recadrés avec `Image Logger` ou `Image Write` pour constituer un jeu de référence à partir des polygones choisis.
* Pour afficher plusieurs superpositions de polygones côte à côte, utilisez `Image Concatenate` ou `Collage Images` avec la sortie `Polygon Images`.
* Pour un prétraitement avant le dessin (par ex. créer un masque binaire à tracer), utilisez en amont `Blur`, `Image Threshold` ou `HSV Filter` afin de simplifier les contours.

## 🛠️ Dépannage

* Rien ne se passe en cliquant sur la toile : vérifiez qu'une image est connectée à `Image Any` et lancez le bloc une fois pour initialiser la toile.
* Impossible de sauvegarder le polygone : assurez-vous que le polygone courant possède au moins trois points avant d'appuyer sur `Press S`.
* Sorties de polygones vides : vérifiez que des polygones ont bien été sauvegardés (utilisez `Press S`) et non uniquement laissés en cours ; les polygones non sauvegardés n'apparaissent pas dans `Polygon Images` ni `Polygons`.
* Découpe polygonale vide : assurez-vous que le polygone se situe bien à l'intérieur des limites de l'image et que l'image contient des données valides. Si besoin, prétraitez l'image avec `Normalize Image` ou `Denoising` avant de dessiner.