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

# Image ROI Select

!\[ ]\(.assets/docs-welcome-flow (1).png)

Ce bloc de fonction vous permet de sélectionner de manière interactive une seule région rectangulaire d'intérêt (ROI) en la traçant directement sur l'aperçu de l'image. Il est idéal pour recadrer une zone d'une image en vue d'un traitement ou d'une inspection ultérieure.

## 📥 Entrées

`Image Any`\
L'image à recadrer. Branchez une image en niveaux de gris ou en couleur pour définir la zone sélectionnable.

## 📤 Sorties

`Image Any`\
L'image recadrée correspondant au rectangle sélectionné.

`Rectangle`\
Le rectangle en pixels décrivant la zone sélectionnée (coordonnées coin supérieur gauche et coin inférieur droit).

## 🕹️ Contrôles

`Image Preview`\
L'aperçu interactif où vous créez et modifiez la ROI rectangulaire à la souris.

`Drag`\
Créez un rectangle en traçant sur l'aperçu, ou glissez à l'intérieur du rectangle pour le déplacer.

`Edge / Corner Drag`\
Redimensionnez le rectangle en traînant un bord ou un coin.

`Ctrl`\
Maintenez pour forcer la création d'un nouveau rectangle même si un rectangle existe déjà.

## 🎯 Fonctionnalités

* Création, déplacement et redimensionnement interactifs du rectangle directement sur l'aperçu image.
* Superposition visuelle affichant le rectangle courant et le mettant en évidence pendant l'interaction.
* Acceptation d'une sélection unique ou répétée ; la ROI la plus récente est utilisée en sortie.
* Le résultat recadré est retourné immédiatement en tant qu'image, accompagné des coordonnées du rectangle.
* Le rectangle sélectionné est conservé pour pouvoir retrouver la même ROI lors du rechargement du projet.

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

* Fournissez une image à l'entrée `Image Any` et exécutez le scénario une fois pour charger l'image dans l'aperçu.
* Utilisez l'aperçu pour `Drag` et dessiner un rectangle. Glissez à l'intérieur du rectangle pour le déplacer, ou traînez les bords/coins pour le redimensionner.
* Le bloc calcule les coordonnées en pixels du rectangle sélectionné et produit en sortie :
  * l'image recadrée extraite de ces coordonnées via `Image Any`
  * les coordonnées du rectangle via `Rectangle`
* La superposition de l'aperçu se met à jour en temps réel pendant la création ou la modification de la ROI.

## 📝 Instructions d'utilisation

1. Connectez un bloc producteur d'images à l'entrée `Image Any` et exécutez une fois pour remplir l'aperçu.
2. Dessinez la ROI en cliquant et en traînant sur l'aperçu.
3. Déplacez ou redimensionnez la ROI selon vos besoins.
4. Maintenez `Ctrl` pendant le traînage pour créer un nouveau rectangle.
5. Utilisez les sorties pour acheminer l'image recadrée ou les coordonnées du rectangle vers des blocs en aval.

## 💡 Astuces

* Combinez avec `Show Image` pour ouvrir le résultat recadré dans un visualiseur plus grand afin de l'inspecter.
* Si vous avez besoin de plusieurs ROI éditables, utilisez `Image ROI Select Multi` à la place de ce bloc.
* Utilisez `Image Resize` après ce bloc pour normaliser les tailles des recadrages avant d'exécuter une détection ou une analyse.
* Alimentez la sortie recadrée dans `Find Object` si vous souhaitez effectuer un template matching uniquement à l'intérieur de la zone sélectionnée — cela réduit les faux positifs et accélère le traitement.
* Sauvegardez les recadrages importants avec `Image Logger` ou `Image Write` pour conserver des exemples destinés à la revue ou à l'entraînement.
* Pour visualiser les détections ou les coordonnées sur l'image originale, utilisez `Draw Rectangle` en aval avec la sortie `Rectangle`.

## 🛠️ Dépannage

* Si l'aperçu est vide, assurez-vous que le bloc producteur est connecté et que vous avez exécuté la pipeline au moins une fois pour charger les données image.
* Si la sélection apparaît en dehors de l'image, vérifiez les dimensions de l'image d'entrée et redessinez la ROI à l'intérieur de la zone d'aperçu.
* Pour le traitement final, confirmez que la résolution de l'image recadrée est appropriée pour les blocs en aval (utilisez `Image Resize` si nécessaire).