> 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/shape-analysis/contour-to-image.md).

# Contour to Image

Cette fonction extrait une région rectangulaire cadrée autour d'un contour donné. Fournissez une image source et un contour (shape) ; le bloc renvoie une image recadrée (rectangulaire) contenant le contour. Utile pour isoler et inspecter un objet détecté dans une image plus large.

## 📥 Inputs

* `Image` — Image source contenant l’objet à recadrer. Peut être en couleur ou en niveaux de gris.
* `Contour` — Forme/contour décrivant la frontière de l’objet. Fournissez un contour obtenu à partir d’un bloc de détection de contours ou de traitement de formes.

## 📤 Outputs

* `Image` — Image rectangulaire recadrée contenant la zone autour du contour fourni.

## 🕹️ Controls

* `No Controls` — Ce bloc n’a pas d’éléments interactifs. Il fonctionne en recevant ses entrées et en produisant automatiquement l’image recadrée.

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

Lorsque le bloc s’exécute, il examine le contour fourni et détermine une zone rectangulaire qui englobe ce contour. Cette zone est extraite de l’image source et renvoyée en sortie du bloc. Si le contour est incliné ou irrégulier, le bloc ajuste un rectangle contenant le contour et renvoie un recadrage rectangulaire pour faciliter le traitement en aval.

## ✨ Fonctionnalités

* Extrait une image rectangulaire centrée sur un contour pour simplifier les analyses suivantes.
* Compatible avec des contours produits par différents blocs de détection et d’analyse de formes.
* Retourne une image prête à l’emploi pour visualisation, reconnaissance ou enregistrement.

## 📝 Comment utiliser

1. Produisez des contours à partir de votre image (par exemple par seuillage puis détection de contours).
2. Connectez l’image source à l’entrée `Image` et le contour choisi à l’entrée `Contour`.
3. Le bloc fournit l’image recadrée au niveau de la sortie `Image`. Utilisez-la ensuite comme entrée pour d’autres blocs (par ex. reconnaissance, OCR ou enregistrement).

## 💡 Conseils pratiques

* Pour générer des contours avant ce bloc, utilisez le bloc `Find Contour`.
* Si vous avez besoin d’un polygone simplifié avant le recadrage, essayez `Approximate Contour` pour réduire le nombre de sommets.
* Pour les objets tournés, comparez les résultats avec `Minimum Rotated Rectangle` ou `Minimum Rectangle` afin de choisir la meilleure forme englobante pour votre workflow.
* Prévisualisez rapidement le recadrage avec le bloc `Show Image`.
* Après le recadrage, appliquez `Image Resize` pour normaliser les tailles, ou `Auto Contrast` / `Denoising` pour préparer l’image aux étapes suivantes.
* Pour enregistrer automatiquement les crops, connectez la sortie de ce bloc à `Image Logger` ou `Image Write`.

## 🛠️ Dépannage

* Si la sortie est inattendue ou vide, vérifiez que l’entrée `Contour` contient bien un contour valide (pas `None`). Utilisez `Find Contour` ou `Approximate Contour` pour obtenir des contours valides.
* Si le recadrage semble tronqué, vérifiez que les coordonnées du contour sont bien dans les limites de l’image source. Ajustez le prétraitement ou la sélection du contour si nécessaire.
* Si l’objet apparaît tourné ou déformé et que vous avez besoin d’une perspective différente, testez `Minimum Rotated Rectangle` ou utilisez un workflow tenant compte de la perspective (recadrage puis `Auto Alignment` / `Perspective Transform`) avant l’analyse ultérieure.