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

# Image ROI Center

Ce bloc fonction coupe une image autour d'un point central spécifié en utilisant une largeur et une hauteur souhaitées. Si aucun centre ni dimensions ne sont fournis, il utilise par défaut le centre de l'image et les dimensions complètes. Il renvoie l'image recadrée et les coordonnées du rectangle utilisé pour le recadrage.

## 📥 Entrées

`Image Any`\
L'image source à recadrer.

`Center`\
Coordonnée du centre pour le recadrage. Si non fournie, le centre de l'image est utilisé. Format : (x, y) ou (col, row) selon votre flux.

`Width`\
Largeur souhaitée du recadrage en pixels. Si non fournie, la largeur de l'image est utilisée.

`Height`\
Hauteur souhaitée du recadrage en pixels. Si non fournie, la hauteur de l'image est utilisée.

## 📤 Sorties

`Image Any`\
L'image recadrée (region of interest) renvoyée en tant que données d'image.

`Rectangle`\
Le rectangle utilisé pour le recadrage, exprimé sous forme de coordonnées réutilisables par d'autres blocs.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles interactifs supplémentaires dans sa zone de widget. Tout le comportement est piloté par les sockets d'entrée.

## 🎯 Fonctionnalités

* Recadrage simple basé sur le centre pour une extraction rapide de ROI.
* Accepte des entrées optionnelles `Width`, `Height` et `Center` pour permettre de modifier dynamiquement le ROI à l'exécution.
* Renvoie l'image recadrée et les coordonnées du rectangle pour que les blocs en aval puissent visualiser ou réutiliser le ROI.

## 📝 Instructions d'utilisation

1. Connectez votre source d'image à l'entrée `Image Any`.
2. Facultatif : fournissez une coordonnée `Center` pour modifier le centre du recadrage.
3. Facultatif : fournissez `Width` et/ou `Height` pour définir la taille du recadrage.
4. Utilisez la sortie `Image Any` comme image recadrée et la sortie `Rectangle` pour dessiner ou sauvegarder le ROI.

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

Lorsque le bloc s'exécute, il détermine le centre, la largeur et la hauteur à partir des entrées (ou utilise des valeurs par défaut pertinentes), calcule ensuite le rectangle dans les limites de l'image et renvoie l'image recadrée ainsi que les coordonnées du rectangle.

## 💡 Conseils et astuces

* Combinez avec `Show Image` pour prévisualiser rapidement le résultat du recadrage.
* Utilisez `Image ROI Select` ou `Image ROI Polygon` plus tôt dans le flux pour définir ou affiner interactivement le centre avant de l'envoyer à ce bloc.
* Envoyez la sortie recadrée à `Find Object`, `Object Detection` ou `Mask Detection` pour concentrer la détection sur une zone plus petite et accélérer le traitement.
* Ajoutez `Image Resize` après ce bloc pour normaliser la taille du recadrage pour des algorithmes qui attendent des dimensions fixes.
* Envoyez l'image recadrée à `Image Logger` ou `Image Write` pour sauvegarder des échantillons de la région d'intérêt en vue d'inspection ou d'entraînement.

## 🛠️ Dépannage

* Si le recadrage est vide ou semble incorrect, vérifiez les entrées `Center`, `Width` et `Height` pour vous assurer qu'elles sont dans les limites de l'image.
* Si le bloc en aval attend un ordre de canaux ou une taille spécifique, ajoutez `Image Resize` ou des conversions de couleur avant ce bloc.
* Si vous observez des coordonnées inattendues, utilisez `Show Image` ou `Draw Rectangle` pour visualiser la sortie `Rectangle` et vérifier le positionnement du ROI.