Draw Result On Image

Ce bloc fonction superpose un résultat textuel sur une image d'entrée en fonction d'une condition booléenne. Il est utile pour annoter des états pass/fail, des messages de statut ou tout autre résultat binaire directement sur l'image avant un traitement ou une affichage ultérieur.

📥 Entrées (sockets)

Image (socket d'entrée) L'image qui recevra le texte superposé. Condition (socket d'entrée) Une valeur booléenne qui détermine quel texte et quelle couleur seront dessinés. Success Condition Text (socket d'entrée) Texte à afficher lorsque la condition est vraie. Fail Condition Text (socket d'entrée) Texte à afficher lorsque la condition est fausse.

📤 Sorties (sockets)

Image (socket de sortie) L'image résultante avec le texte superposé.

🕹️ Contrôles

Font Scale Ajuste la taille relative de la police du texte superposé pour s'adapter à différentes résolutions d'image. Horizontal Position Déplace le texte à gauche/droite sur une échelle simple 0..10 pour un placement rapide. Vertical Position Déplace le texte haut/bas sur une échelle simple 0..10 pour un placement rapide.

🎨 Fonctionnalités

• Retour visuel pass/fail : lorsque la Condition est vraie, le bloc dessine le texte de Success Condition Text en vert ; sinon il dessine le texte de Fail Condition Text en bleu.

• Taille adaptée à la résolution : la taille de la police s'adapte aux dimensions de l'image pour que le texte reste lisible sur différentes résolutions.

• Placement rapide : les curseurs horizontal et vertical offrent un positionnement rapide, convivial et sans coordonnées manuelles.

📝 Instructions d'utilisation

1. Fournissez une image au socket Image.

2. Alimentez le socket Condition avec un signal booléen indiquant succès ou échec. Vous pouvez générer ce signal avec des blocs logiques tels que Logic Input, Equals, And, ou Greater.

3. Facultatif : renseignez des chaînes personnalisées dans Success Condition Text et Fail Condition Text pour contrôler les messages affichés.

4. Ajustez les contrôles Font Scale, Horizontal Position et Vertical Position jusqu'à ce que le texte soit correctement placé et dimensionné.

5. Utilisez la sortie Image pour poursuivre le traitement, afficher avec le bloc Show Image, ou enregistrer avec Image Write / Image Logger.

📊 Évaluation

Lors de l'exécution, le bloc copie l'image d'entrée, choisit le texte à dessiner en fonction du socket Condition, rend le texte en utilisant l'échelle de police et les paramètres de position choisis, puis renvoie l'image annotée via le socket de sortie Image.

💡 Astuces et conseils

• Combinez avec des blocs de détection comme Object Detection, Object Detection - Custom, ou Mask Detection pour afficher des résultats OK/NOK par image (par exemple, afficher "OK" lorsqu'un objet est détecté ou "Fail" lorsqu'il ne l'est pas).

• Utilisez Draw Detections en complément pour afficher les boîtes englobantes, puis ajoutez un label global pass/fail avec ce bloc.

• Placez un Image ROI ou Image ROI Select avant ce bloc pour recadrer une région d'intérêt et positionner le texte relativement à cette région.

• Pour journaliser ou sauvegarder les images annotées, connectez la sortie à Image Logger, Image Write, ou Record Video.

• Construisez des conditions complexes avec des blocs logiques comme And, Or, Not ou des comparaisons (Greater, Equals) et alimentez le booléen final dans le socket Condition.

🛠️ Dépannage

• Aucun texte n'apparaît : vérifiez que les sockets Success Condition Text ou Fail Condition Text sont définis (ils peuvent être laissés vides, mais alors rien ne sera dessiné).

• Texte placé hors image : ajustez les curseurs Horizontal Position et Vertical Position ; augmentez ou diminuez Font Scale pour un meilleur ajustement sur des images très grandes ou très petites.

• Texte trop petit ou trop grand : modifiez Font Scale et prévisualisez avec le bloc Show Image pour trouver le bon équilibre.