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.