> 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/detectors/find-reference.md).

# Find Reference

Ce bloc fonction localise une instance unique d'une image de référence dans une image cible, estime sa position et son orientation, et renvoie des résultats visuels et géométriques pour inspecter ou traiter l'objet détecté.

## 📥 Entrées

* `Object Image` — L'image dans laquelle la référence doit être trouvée (image cible).
* `Reference Image` — La petite image de référence utilisée pour la recherche dans l'`Object Image`.
* `Reference Image ROI` — Entrée de forme optionnelle pour limiter la correspondance à une région à l'intérieur de la référence (utile pour ignorer des parties non pertinentes).

## 📤 Sorties

* `Result Image` — L'`Object Image` annotée avec le polygone délimitant la référence détectée.
* `Detected Object Image` — Une découpe perspective-corrigée de l'objet détecté, transformée pour correspondre à l'orientation/taille de la référence.
* `Keypoints Image` — Visualisation des features/keypoints détectés sur l'image pour vérifier la qualité des correspondances.
* `Bounding Box` — Le rectangle englobant qui délimite la référence détectée dans l'`Object Image`.
* `Corner Coordinates` — Les coordonnées des quatre coins du polygone de la zone détectée.
* `Center Position` — Le point central (x, y) de la référence détectée.

## 🕹️ Contrôles

Ce bloc n'expose pas de widgets supplémentaires en dehors de ses entrées. Utilisez l'entrée `Reference Image ROI` pour limiter la zone de référence si nécessaire.

## 🎨 Fonctionnalités

* Résultat visuel avec superposition polygonale pour vérification rapide.
* Fournit à la fois une découpe perspective-corrigée et des sorties géométriques (coins, bounding box, centre) pour le traitement en aval.
* Accepte une ROI optionnelle sur la référence pour focaliser la correspondance sur une sous-région.
* Produit une visualisation des keypoints pour aider au débogage de la qualité de la correspondance.

## 📝 Instructions d'utilisation

1. Fournissez l'image source à `Object Image` et le modèle/référence à `Reference Image`.
2. Facultatif : connectez une forme à `Reference Image ROI` pour cibler une zone précise dans la référence.
3. Lancez le scénario — le bloc tentera de trouver la référence et produira des visuels annotés et des données géométriques.
4. Utilisez les sorties pour superposer des informations, recadrer, mesurer ou alimenter une logique de décision.

## 📊 Comment ça marche

Lors de l'exécution, le bloc compare des caractéristiques visuelles distinctives entre la référence et l'image cible, estime la position et l'orientation du meilleur appariement, et renvoie une annotation visuelle ainsi que des sorties numériques et transformées représentant l'objet trouvé.

## 💡 Conseils et astuces

* Pour focaliser la détection sur une zone spécifique de l'image d'entrée, recadrez au préalable avec `Image ROI Select` ou `Image ROI` et alimentez l'`Object Image` avec l'image recadrée.
* Si l'échelle ou l'orientation diffère significativement entre référence et objet, essayez de redimensionner les entrées avec `Image Resize` avant la correspondance.
* Améliorez la robustesse face à des variations d'éclairage en prétraitant avec `Adjust Colors`, `Contrast Optimization` ou `Blur` pour réduire le bruit.
* Utilisez `Show Image` pour prévisualiser interactivement `Result Image` ou `Detected Object Image` pendant l'ajustement des entrées.
* Combinez la sortie du bloc avec `Draw Detections` ou `Draw Result On Image` pour superposer des annotations textuelles ou rectangulaires sur des images en direct.
* Si vous avez besoin d'une matrice de perspective pour d'autres mesures, suivez avec `Perspective Transform` en utilisant les `Corner Coordinates` détectées.
* Si l'appariement retourne de nombreux faux positifs, essayez de limiter les features de la référence avec `Reference Image ROI` ou appliquez `Image Threshold` sur les entrées pour simplifier les textures.

(hint) Pour les flux basés sur des régions, utilisez `Get ROI` après la détection pour extraire et transmettre la zone détectée vers d'autres blocs de traitement.

## 🛠️ Dépannage

* Aucune détection : vérifiez que la référence apparaît dans l'image cible avec suffisamment de texture visible ; augmentez la taille de la référence dans l'image cible ou utilisez `Image Resize`.
* Correspondances faibles ou instables : améliorez l'éclairage et le contraste avec `Adjust Colors` ou `Contrast Optimization` ; réduisez le bruit avec `Blur`.
* Détection localisée mais découpe déformée incorrecte : validez les coordonnées des coins via `Show Image` sur la `Keypoints Image` et envisagez de restreindre la `Reference Image ROI`.
* Traitement lent sur de grandes images : réduisez l'échelle avec `Image Resize` avant d'alimenter ce bloc, puis mappez les résultats aux coordonnées originales si nécessaire.