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

Image ROI Select

![ ](.assets/docs-welcome-flow (1).png)

Ce bloc de fonction vous permet de sélectionner de manière interactive une seule région rectangulaire d'intérêt (ROI) en la traçant directement sur l'aperçu de l'image. Il est idéal pour recadrer une zone d'une image en vue d'un traitement ou d'une inspection ultérieure.

📥 Entrées

Image Any L'image à recadrer. Branchez une image en niveaux de gris ou en couleur pour définir la zone sélectionnable.

📤 Sorties

Image Any L'image recadrée correspondant au rectangle sélectionné.

Rectangle Le rectangle en pixels décrivant la zone sélectionnée (coordonnées coin supérieur gauche et coin inférieur droit).

🕹️ Contrôles

Image Preview L'aperçu interactif où vous créez et modifiez la ROI rectangulaire à la souris.

Drag Créez un rectangle en traçant sur l'aperçu, ou glissez à l'intérieur du rectangle pour le déplacer.

Edge / Corner Drag Redimensionnez le rectangle en traînant un bord ou un coin.

Ctrl Maintenez pour forcer la création d'un nouveau rectangle même si un rectangle existe déjà.

🎯 Fonctionnalités

  • Création, déplacement et redimensionnement interactifs du rectangle directement sur l'aperçu image.

  • Superposition visuelle affichant le rectangle courant et le mettant en évidence pendant l'interaction.

  • Acceptation d'une sélection unique ou répétée ; la ROI la plus récente est utilisée en sortie.

  • Le résultat recadré est retourné immédiatement en tant qu'image, accompagné des coordonnées du rectangle.

  • Le rectangle sélectionné est conservé pour pouvoir retrouver la même ROI lors du rechargement du projet.

⚙️ Mécanisme d'exécution

  • Fournissez une image à l'entrée Image Any et exécutez le scénario une fois pour charger l'image dans l'aperçu.

  • Utilisez l'aperçu pour Drag et dessiner un rectangle. Glissez à l'intérieur du rectangle pour le déplacer, ou traînez les bords/coins pour le redimensionner.

  • Le bloc calcule les coordonnées en pixels du rectangle sélectionné et produit en sortie :

    • l'image recadrée extraite de ces coordonnées via Image Any

    • les coordonnées du rectangle via Rectangle

  • La superposition de l'aperçu se met à jour en temps réel pendant la création ou la modification de la ROI.

📝 Instructions d'utilisation

  1. Connectez un bloc producteur d'images à l'entrée Image Any et exécutez une fois pour remplir l'aperçu.

  2. Dessinez la ROI en cliquant et en traînant sur l'aperçu.

  3. Déplacez ou redimensionnez la ROI selon vos besoins.

  4. Maintenez Ctrl pendant le traînage pour créer un nouveau rectangle.

  5. Utilisez les sorties pour acheminer l'image recadrée ou les coordonnées du rectangle vers des blocs en aval.

💡 Astuces

  • Combinez avec Show Image pour ouvrir le résultat recadré dans un visualiseur plus grand afin de l'inspecter.

  • Si vous avez besoin de plusieurs ROI éditables, utilisez Image ROI Select Multi à la place de ce bloc.

  • Utilisez Image Resize après ce bloc pour normaliser les tailles des recadrages avant d'exécuter une détection ou une analyse.

  • Alimentez la sortie recadrée dans Find Object si vous souhaitez effectuer un template matching uniquement à l'intérieur de la zone sélectionnée — cela réduit les faux positifs et accélère le traitement.

  • Sauvegardez les recadrages importants avec Image Logger ou Image Write pour conserver des exemples destinés à la revue ou à l'entraînement.

  • Pour visualiser les détections ou les coordonnées sur l'image originale, utilisez Draw Rectangle en aval avec la sortie Rectangle.

🛠️ Dépannage

  • Si l'aperçu est vide, assurez-vous que le bloc producteur est connecté et que vous avez exécuté la pipeline au moins une fois pour charger les données image.

  • Si la sélection apparaît en dehors de l'image, vérifiez les dimensions de l'image d'entrée et redessinez la ROI à l'intérieur de la zone d'aperçu.

  • Pour le traitement final, confirmez que la résolution de l'image recadrée est appropriée pour les blocs en aval (utilisez Image Resize si nécessaire).

Mis à jour