For the complete documentation index, see llms.txt. This page is also available as Markdown.

Draw Detections

Cette fonction superpose les résultats de détection sur une image en traçant des rectangles et un verdict textuel (OK / Nok) pour chaque objet détecté. Elle est prévue comme étape finale de visualisation ou d'inspection dans une chaîne de traitement visuel.

📥 Entrées

  • Image Image principale sur laquelle dessiner les annotations. (prise d'entrée)

  • Coordinate_List Liste de coordonnées des rectangles à dessiner. Chaque élément doit être une paire de points définissant un rectangle. (prise d'entrée)

  • Object_Count Liste de compteurs/indicateurs correspondant à chaque rectangle. Sert à déterminer le statut OK (vert) ou Nok (rouge). (prise d'entrée)

  • Trigger Booléen pour activer le dessin. Si non actif, le bloc ne produit rien. (prise d'entrée)

📤 Sorties

  • Result Image L'image avec les rectangles et le texte de statut dessinés. (prise de sortie)

🕹️ Contrôles

Ce bloc n'a pas d'interface utilisateur interne. Son comportement est entièrement commandé via ses prises d'entrée.

🎨 Fonctionnalités

  • Superposition visuelle qui trace des rectangles colorés et des étiquettes textuelles sur l'image d'entrée.

  • Code couleur : vert pour OK, rouge pour Nok — déterminé à partir des valeurs de Object_Count.

  • Gère plusieurs détections en itérant sur les listes de coordonnées et de compteurs.

  • Émet des avertissements lorsque les longueurs de listes ne correspondent pas ou quand les coordonnées sont invalides.

  • Nécessite un Trigger actif pour produire une sortie ; sinon aucun résultat n'est généré.

⚙️ Mécanisme d'exécution

  • Lorsque le bloc reçoit des données et que Trigger est True, il copie l'Image fournie et trace un rectangle pour chaque entrée de Coordinate_List.

  • Pour chaque rectangle, le bloc vérifie la valeur correspondante dans Object_Count. Si la valeur indique une présence (non nulle), le rectangle et l'étiquette sont dessinés en vert avec le texte "Ok". Si la valeur est zéro ou manquante, le rectangle et le texte sont dessinés en rouge avec le texte "Nok".

  • Si le nombre de coordonnées et de compteurs diffère, le bloc émet un avertissement et paire les éléments selon la longueur la plus courte. Les entrées de coordonnées invalides sont ignorées avec un avertissement.

  • L'image annotée finale est envoyée via la sortie Result Image.

📝 Instructions d'utilisation

  1. Fournissez une image source dans Image.

  2. Donnez des listes correspondantes dans Coordinate_List et Object_Count (même longueur recommandée).

  3. Activez Trigger pour générer l'image annotée.

  4. Connectez Result Image à un bloc d'affichage (Show Image) ou d'enregistrement (Image Logger, Image Write) pour inspecter ou sauvegarder les images annotées.

💡 Astuces

  • Utilisez Object Detection ou Object Detection - Custom (ou Object Detection (D-FINE)) pour produire des listes de rectangles et des compteurs, puis connectez leurs sorties vers Coordinate_List et Object_Count.

  • Combinez avec Object_Detection_Tracker pour dessiner des rectangles suivis avec des positions cohérentes ; alimentez les sorties de rectangles suivis dans ce bloc pour des marquages OK/Nok par objet.

  • Utilisez Rectangles in Rectangle ou Check Area pour filtrer les détections avant dessin (exclure les détections hors d'une zone d'intérêt).

  • Prévisualisez avec Show Image et enregistrez avec Image Logger ou Image Write pour conserver un historique.

  • Contrôlez l'apparition des annotations avec Logic Input ou des détecteurs d'arête comme Rising Edge afin de dessiner seulement sur des images sélectionnées.

  • Pour tracer un seul rectangle, utilisez Draw Rectangle ; ce bloc est adapté quand vous avez plusieurs détections et souhaitez un marquage automatique OK/Nok.

🛠️ Dépannage

  • Pas de sortie : vérifiez que Trigger est True et qu'une image valide est connectée à Image.

  • Listes de longueurs différentes : si Coordinate_List et Object_Count ont des longueurs différentes, vous verrez des avertissements et certains éléments pourront être ignorés — assurez-vous que les blocs en amont produisent des listes alignées.

  • Coordonnées invalides : si des entrées de coordonnées sont malformées, le bloc les ignorera et affichera un avertissement ; vérifiez le format envoyé par les blocs de détection.

  • Pour conserver les résultats ou les inspecter image par image, connectez Result Image à Show Image ou à des blocs d'enregistrement comme Image Logger.

Mis à jour