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

# Get ROI

Cette fonction extrait une région rectangulaire d'une image d'entrée. Utilisez-la lorsque vous souhaitez recadrer une zone spécifique pour une analyse ou une visualisation ultérieure.

## 📥 Entrées

`Image Any` Image source à partir de laquelle extraire la région.

`Rectangle` Coordonnées du rectangle définissant la région à extraire (généralement deux points de coin).

## 📤 Sorties

`Image Any` La région recadrée sous forme d'image.

## 🕹️ Contrôles

Ce bloc fonction n'a pas de widgets interactifs internes. Fournissez le rectangle via une entrée de forme ou provenant d'autres blocs de sélection ROI.

## 🎨 Fonctionnalités

* Recadrage rectangulaire simple livré en sortie image pour les blocs en aval.
* Accepte le rectangle en entrée sous forme de deux coordonnées de coin (par ex., top-left et bottom-right).
* Gère automatiquement les valeurs de rectangle en dehors des limites de l'image pour éviter les erreurs d'exécution.

## 📝 Instructions d'utilisation

1. Connectez l'image source à l'entrée `Image Any`.
2. Fournissez un `Rectangle` décrivant la région à extraire. Celui-ci peut être produit par des blocs de sélection ROI interactifs ou par d'autres blocs qui renvoient des coordonnées de rectangle.
3. Utilisez la sortie `Image Any` pour envoyer la région recadrée aux blocs suivants.

## 📊 Évaluation

Lors de l'exécution, ce bloc retourne l'image contenue dans le rectangle fourni. Si le rectangle dépasse les bords de l'image, la région sera tronquée à la zone valide de l'image.

## 💡 Astuces

* Pour une sélection interactive, combinez avec `Image ROI Select` pour dessiner un rectangle sur la source et branchez sa sortie dans l'entrée `Rectangle`.
* Pour extraire plusieurs régions à la fois, utilisez `Image ROI Select Multi` ou `Image ROI Polygon Multi` pour générer plusieurs rectangles ou polygones, puis alimentez chaque rectangle dans des instances séparées de ce bloc ou itérez à l'aide de blocs de contrôle de flux.
* Prévisualisez le résultat recadré en connectant la sortie à `Show Image`.
* Utilisez `Image Resize` ou `Image Padding` après ce bloc si le bloc en aval requiert une taille d'image spécifique.
* Pour les flux de travail centrés sur les objets, recadrez d'abord la zone (avec ce bloc) puis exécutez `Find Object`, `Template Match` ou `Histogram On Line` sur la zone extraite pour améliorer la rapidité et réduire les faux positifs.
* Si vous avez besoin d'un recadrage centré, associez avec `Image ROI Center` pour générer un rectangle autour d'un point central choisi.
* Utilisez `Draw Rectangle` sur un chemin d'affichage pour visualiser le ROI sélectionné sur l'image originale à des fins de vérification.

## 🛠️ Dépannage

* Si la sortie est vide ou tronquée de manière inattendue, vérifiez que le `Rectangle` contient deux coordonnées de coin valides à l'intérieur des limites de l'image.
* Si le recadrage semble décalé ou inversé, assurez-vous que le rectangle est fourni sous forme de paires top-left et bottom-right (ou l'ordre de coordonnées accepté par votre source ROI).
* Si vous avez besoin d'un ROI de taille cohérente malgré des résolutions d'image variables, ajoutez `Image Resize` avant ou après ce bloc pour normaliser les dimensions.