> 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/minimum-rotated-rectangle.md).

# Minimum Rotated Rectangle

Ce bloc fonction calcule le plus petit rectangle tourné qui englobe une forme donnée (contour) dans une image. Il est utile pour mesurer la taille et l'orientation d'objets orientés, et pour visualiser une géométrie de délimitation qui n'est pas alignée sur les axes.

## 📥 Entrées

* `Image`\
  L'image source utilisée pour la visualisation et comme référence.
* `Contour`\
  La forme/contour utilisée pour calculer le rectangle rotatif minimal.

## 📤 Sorties

* `Image`\
  L'image source annotée avec le rectangle tourné calculé et le contour.
* `Center`\
  Le point central du rectangle tourné calculé.
* `Width`\
  La valeur de largeur du rectangle tourné.
* `Height`\
  La valeur de hauteur du rectangle tourné.
* `Angle`\
  L'angle de rotation du rectangle (orientation).
* `Contour`\
  La représentation du contour du rectangle tourné (en sortie forme).
* `Rectangle Image`\
  Une visualisation séparée montrant la région du rectangle recadrée/rectifiée.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles modifiables par l'utilisateur. Il s'exécute automatiquement lorsque les deux entrées sont fournies.

## 🎯 Fonctionnalités

* Calcule un rectangle d'aire minimale pouvant être tourné par rapport aux axes de l'image.
* Fournit des mesures géométriques : centre, largeur, hauteur et angle.
* Visualise les résultats directement sur l'image source et sous forme d'une image de rectangle séparée.
* Produit le rectangle en tant que `Contour`/forme afin qu'il puisse être acheminé vers d'autres blocs pour un traitement ultérieur.

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

Lorsque `Image` et `Contour` sont fournis, le bloc analyse la forme du contour pour déterminer le rectangle d'aire minimale qui l'englobe. Le bloc produit ensuite des mesures numériques pour la taille et l'orientation, dessine le rectangle sur l'image pour un retour visuel immédiat, et fournit également le rectangle sous forme de sortie `Contour` et `Rectangle Image`. Si aucun contour valide n'est fourni, le bloc ne produira pas de résultats géométriques (il émettra des sorties vides ou par défaut).

## 📝 Instructions d'utilisation

1. Fournissez une entrée `Contour` représentant l'objet d'intérêt (voir les Astuces pour obtenir des contours).
2. Alimentez l'entrée `Image` avec la même image de référence (ou une copie) si vous souhaitez une visualisation annotée.
3. Lisez les valeurs `Center`, `Width`, `Height` et `Angle` pour les mesures ou la logique de décision.
4. Utilisez la sortie `Rectangle Image` lorsque vous avez besoin d'une vue recadrée ou rectifiée de l'objet détecté.

## 💡 Astuces

* Pour obtenir des contours à partir d'images brutes, combinez avec `Find Contour` ou `Feature Detector` pour extraire les contours d'objet avant de les fournir à ce bloc.
* Si les contours sont bruyants ou contiennent beaucoup de points, utilisez `Approximate Contour` pour simplifier le contour et améliorer la stabilité des mesures.
* Pour des formes mieux englobées par des coques convexes, essayez d'abord `Hull Convex` et fournissez la coque à ce bloc.
* Comparez différentes géométries d'enveloppe en associant ce bloc avec `Minimum Circle`, `Minimum Ellipse` ou `Minimum Rectangle` pour choisir la meilleure solution pour votre application.
* Utilisez `Image ROI Select` ou `Image ROI` pour recadrer la région avant l'extraction des contours lorsque vous ne vous intéressez qu'à une sous-région de l'image.
* Visualisez ou exportez les résultats avec `Draw Rectangle` ou `Draw Result On Image` pour des superpositions claires dans des rapports ou l'interface utilisateur.

## 🛠️ Dépannage

* Pas de mesures produites : assurez-vous qu'un `Contour` valide est connecté à l'entrée `Contour` et que le contour n'est pas vide.
* Orientation ou taille inattendue : essayez de simplifier le contour avec `Approximate Contour` ou vérifiez que le contour correspond bien à l'objet visé (utilisez `Contour to Image` pour l'inspecter).
* Rectangle ne couvre pas correctement l'objet : vérifiez l'étape d'extraction du contour pour des trous ou des fragments déconnectés ; envisagez d'utiliser `Hull Convex` pour créer une enveloppe avant la mesure.