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

Image ROI Select Multi

Bloc interactif pour sélectionner et éditer plusieurs Regions Of Interest (ROIs) rectangulaires sur une image. Dessinez, déplacez et redimensionnez des rectangles directement dans l'aperçu de l'image pour obtenir des images recadrées et des coordonnées de rectangles en pixels destinées au traitement en aval.

📥 Entrées

Image Connectez une image en couleur ou en niveaux de gris qui servira de source pour la sélection des ROIs.

📤 Sorties

Images Images recadrées pour chaque ROI (liste). Rectangles Rectangles en pixels pour chaque ROI (liste). Selected Image Recadrage pour le ROI actuellement sélectionné (image unique ou None). Selected Rectangle Rectangle en pixels du ROI sélectionné (rectangle unique ou None).

🕹️ Contrôles

  • Draw : cliquer-glisser sur une zone vide de l'image pour créer un nouveau ROI.

  • Move : cliquer-glisser à l'intérieur d'un rectangle pour le déplacer.

  • Resize : cliquer-glisser les bords ou coins du rectangle pour redimensionner.

  • Ctrl Maintenir pendant le glissement pour forcer la création d'un nouveau rectangle (même au-dessus d'un ROI existant).

  • C Appuyer pour effacer tous les ROIs.

  • U Appuyer pour annuler le dernier ROI créé.

  • Delete / Backspace Appuyer pour supprimer le ROI sélectionné.

  • Escape Appuyer pour annuler la sélection/le glissement.

L'aperçu affiche des superpositions et des poignées pour indiquer les états de survol, de sélection et d'aperçu.

🎨 Fonctionnalités

  • Édition multi-ROI : créez plusieurs ROIs rectangulaires dans une même session d'image.

  • Aperçu en direct : superposition interactive et mises à jour de l'aperçu pendant l'édition.

  • Sorties précises au pixel : Rectangles et Selected Rectangle sont fournis en coordonnées de pixels relatives à l'image source.

  • UI réactive : l'aperçu se redimensionne pour s'adapter à la zone du bloc en conservant des superpositions cohérentes.

  • Sérialisation : les ROIs et la sélection sont préservés lors de l'enregistrement/du chargement d'un scénario.

📊 Fonctionnement

  • Lorsqu'une image arrive sur l'entrée Image, le bloc la stocke comme source courante et met à jour l'aperçu.

  • Le bloc convertit les définitions de ROI courantes en rectangles en pixels en utilisant la taille de l'image source et produit les sorties : Images (recadrages par ROI), Rectangles (coordonnées en pixels), Selected Image et Selected Rectangle.

  • Si aucune image n'est connectée, le bloc renvoie des listes vides et des valeurs None (pas de recadrages).

📝 Instructions d'utilisation

  1. Connectez un bloc producteur d'images à l'entrée Image (caméra, loader, stream).

  2. Cliquez-glissez sur l'aperçu de l'image pour créer des ROIs. Utilisez les bords/coins pour ajuster la taille.

  3. Cliquez à l'intérieur d'un rectangle pour le sélectionner ; le recadrage sélectionné est disponible via Selected Image.

  4. Utilisez les raccourcis clavier (C, U, Delete/Backspace, Escape) et maintenez Ctrl pour modifier le comportement de création.

  5. Utilisez les sorties dans des blocs en aval pour analyser ou sauvegarder les recadrages.

💡 Conseils et astuces

  • Inspection rapide : connectez la sortie Selected Image au bloc Show Image pour prévisualiser le recadrage sélectionné dans un visualiseur plus grand.

  • Traitement par lot : envoyez la sortie Images vers Collage Images pour créer une vue combinée de tous les recadrages, ou vers Image Logger / Image Write pour sauvegarder automatiquement les recadrages.

  • Analyse focalisée : utilisez la sortie Rectangles comme entrée pour Get ROI lorsque vous souhaitez appliquer la même liste de rectangles à d'autres images (par exemple séries temporelles ou frames différentes).

  • Combinaison avec des détecteurs : créez des ROIs pour localiser les zones d'intérêt, puis envoyez les images recadrées (Images) vers des blocs tels que Find Object, Feature Detector, Blob Detector ou OCR pour effectuer des détections/reconnaissances ciblées sur chaque recadrage.

  • Visualisation : dessinez les Rectangles renvoyés sur l'image source à l'aide de Draw Rectangle ou Draw Detections pour visualiser les résultats avec d'autres annotations.

  • Prétraitement : avant la sélection manuelle des ROIs, vous pouvez préparer l'image source avec Blur, Image Threshold ou HSV Filter pour rendre les structures plus faciles à voir et à sélectionner.

  • Utilisation dans des boucles de pipeline : passez les recadrages ROI vers des blocs Analysis ou AI (par exemple Object Detection ou Background Removal) pour créer des flux de traitement efficaces par région.

🛠️ Dépannage

  • Pas d'aperçu ou contrôles désactivés : assurez-vous qu'une image valide est connectée à l'entrée Image.

  • ROIs mal exportés : vérifiez que l'image source a des dimensions correctes ; le bloc fournit des rectangles en pixels relatifs à la taille de l'image d'entrée.

  • Comportement de sélection inattendu : maintenez Ctrl pendant le glissement pour forcer la création d'un nouveau ROI au lieu de modifier un ROI existant.

  • Trop ou pas assez de ROIs dans les étapes en aval : vérifiez que vous utilisez la bonne sortie (Images vs Selected Image) et que les blocs en aval acceptent des entrées de type liste lorsque vous envoyez plusieurs recadrages.

Mis à jour