Shape Detector

Ce bloc fonction trouve une forme distincte dans une image couleur en appliquant des filtres, une binarisation (thresholding) et une analyse de contours. Il renvoie un résultat visuel et des descripteurs numériques de la forme exploitables par d'autres blocs.

📥 Entrées

Image Entrée acceptant une image couleur à analyser.

📤 Sorties

Filtered Image Image binaire ou filtrée utilisée pour l'extraction des contours (retour visuel du prétraitement).

Contoured Image Image originale avec le(s) contour(s) détecté(s) dessinés.

Shape Image Image recadrée ou isolée montrant la forme extraite.

Border Coordinate Coordonnées du(s) contour(s) qui forment la bordure détectée.

Shape Width Largeur détectée de la forme.

Shape Height Hauteur détectée de la forme.

Shape Position Position du centre de la forme détectée.

Shape Rotation Angle de rotation de la forme détectée.

🕹️ Contrôles

Blur coefficient Curseur pour régler la force du flou médian avant le thresholding. Réduit le bruit tout en préservant les bords.

Clear spots parameter Curseur pour définir la taille de fermeture morphologique. Utile pour supprimer de petits trous ou joindre des parties d'un objet.

Auto threshold ? Case à cocher pour activer le seuillage automatique (Otsu). Quand activée, la saisie manuelle de Threshold range est désactivée.

Threshold range Curseur double pour définir manuellement les valeurs basse/haute du seuil. Actif si Auto threshold ? est décoché.

Shape area range % Curseur double pour limiter les contours détectés par aire relative (pourcentage de l'image). Permet d'ignorer des objets très petits ou très grands.

⚙️ Mécanisme d'exécution

• Lorsqu'une image arrive sur l'entrée Image, le bloc applique le flou choisi, le seuillage (auto ou manuel) et la fermeture morphologique.

• Les contours sont extraits depuis Filtered Image. Le bloc retient les contours dont l'aire se situe dans la plage Shape area range % et renvoie le plus grand contour valide ainsi que les sorties associées.

• Les sorties visuelles montrent l'image filtrée et le contour détecté superposé sur l'image d'origine pour vérifier facilement le résultat.

• L'activation de Auto threshold ? désactive instantanément le contrôle manuel Threshold range, ce qui permet d'expérimenter plus rapidement.

✨ Fonctionnalités

• Sorties visuelles pour débogage : image seuillée et superposition des contours.

• Prétraitement flexible : flou médian et paramètres de fermeture morphologique.

• Filtrage par aire pour éviter les contours parasites liés au bruit ou aux bords.

• Production de sorties visuelles et decripteurs numériques (taille, position, rotation) utilisables par la logique aval ou pour journalisation.

📝 Instructions d'utilisation

1. Injectez une image couleur sur l'entrée Image.

2. Commencez avec un Blur coefficient modéré et un Clear spots parameter faible.

3. Testez d'abord Auto threshold ?. Si le résultat est bruité, décochez et ajustez Threshold range manuellement.

4. Ajustez Shape area range % pour que l'objet voulu tombe dans la plage d'aire autorisée.

5. Vérifiez Filtered Image et Contoured Image pour confirmer la détection. Utilisez ensuite les sorties Shape Position ou Shape Rotation dans des blocs en aval.

💡 Conseils et astuces

• Si l'image présente du bruit couleur ou des variations d'éclairage, ajoutez en amont un prétraitement avec HSV Filter ou Adjust Colors pour mieux séparer l'objet du fond.

• Utilisez Blur ou Denoising en amont pour réduire le grain avant seuillage et obtenir des contours plus stables.

• Pour analyser une sous-région seulement, recadrez d'abord avec Image ROI Select ou Image ROI et fournissez l'image recadrée à ce bloc.

• Pour convertir une scène couleur bruitée en une entrée binaire plus propre, combinez avec Image Adaptive Threshold ou Image Threshold avant ce bloc.

• Pour un traitement géométrique ou une extraction de caractéristiques supplémentaire, connectez les sorties aux blocs Approximate Contour, Minimum Rectangle, Minimum Rotated Rectangle ou Translate Shape.

• Visualisez les résultats en temps réel avec Show Image et enregistrez des exemples ou des journaux avec Image Logger ou Image Write.

🛠️ Dépannage

• Aucun contour trouvé : augmentez la borne supérieure ou diminuez la borne inférieure de Shape area range % ; vérifiez Filtered Image pour s'assurer que l'objet apparaît après seuillage.

• Trop de petits contours : augmentez Clear spots parameter (fermeture morphologique) ou serrez la limite minimale dans Shape area range %.

• Objet fragmenté en plusieurs contours : réduisez le flou ou diminuez la fermeture morphologique, ou recadrez la région avec Image ROI Select pour isoler l'objet.

• Threshold qui ne fonctionne pas : essayez d'activer Auto threshold ? pour que le bloc choisisse automatiquement un seuil adapté, puis affinez éventuellement Threshold range manuellement.