Image ROI

Ce bloc fonction permet de recadrer (crop) une région d’intérêt à partir d’une image d’entrée en utilisant des curseurs de plage horizontaux. Ajustez les curseurs Width et Height pour définir un recadrage rectangulaire ; le bloc fournit en sortie l’image recadrée et les coordonnées du rectangle pour un traitement ultérieur.

📥 Entrées

Image Any Fournissez l’image source à recadrer.

📤 Sorties

Image Any Image recadrée correspondant au rectangle sélectionné.

Rectangle Coordonnées de la ROI sélectionnée sous forme d’un rectangle.

🕹️ Contrôles

Width Curseur de plage horizontal pour définir les limites gauche/droite du recadrage (min et max).

Height Curseur de plage vertical pour définir les limites haut/bas du recadrage (min et max).

Input Image Size (H, W) Étiquette informative qui affiche les dimensions de l’image d’entrée et met automatiquement à jour les plages des curseurs.

⚙️ Mécanisme d’exécution

Lorsqu’un bloc reçoit une image d’entrée, il lit ses dimensions et met à jour les plages des curseurs Width et Height pour correspondre à la taille de l’image. Les curseurs fournissent des valeurs entières min/max qui définissent le rectangle de recadrage. À l’évaluation, le bloc renvoie l’image recadrée ainsi qu’un shape rectangle représentant la ROI.

🎯 Fonctionnalités

• Plages de curseurs dynamiques qui s’adaptent automatiquement à la taille de l’image connectée.

• Renvoie à la fois l’image recadrée et les coordonnées du rectangle pour une utilisation en aval.

• Préserve la disposition des canaux d’image (couleur ou niveaux de gris) dans le résultat recadré.

• Se souvient et restaure la taille de l’image d’entrée lors de l’enregistrement/chargement des scénarios (prise en charge de la sérialisation).

📝 Instructions d’utilisation

1. Branchez un bloc produisant une image sur l’entrée Image Any.

2. Vérifiez l’étiquette Input Image Size (H, W) pour confirmer les dimensions.

3. Ajustez le curseur Width (min/max) pour définir les limites horizontales du recadrage.

4. Ajustez le curseur Height (min/max) pour définir les limites verticales du recadrage.

5. Utilisez les sorties selon vos besoins : envoyez l’image recadrée vers des blocs d’analyse ou utilisez les coordonnées du rectangle pour la visualisation.

💡 Astuces

• Pour inspecter visuellement la ROI pendant le réglage des curseurs, envoyez la sortie Image Any vers un bloc Show Image.

• Si l’image d’entrée est très grande, placez un bloc Image Resizer avant ce bloc pour accélérer les ajustements interactifs des curseurs.

• Si vous préférez sélectionner la zone de recadrage à la souris plutôt qu’avec des curseurs, utilisez Image ROI Select ou Image ROI Select Multi, puis injectez le rectangle obtenu dans ce bloc ou utilisez ses sorties en aval.

• Pour des détections plus ciblées dans la zone recadrée, alimentez l’image recadrée vers des bloqueurs détecteurs tels que Find Object, Object Detection, ou Blob Detector afin de réduire les faux positifs et d’accélérer le traitement.

• Pour sauvegarder des exemples de la ROI ou les consigner, connectez la sortie image recadrée à Image Logger ou Image Write.

• Pour marquer la ROI sur l’image originale pour la visualisation, utilisez la sortie Rectangle avec Draw Rectangle puis prévisualisez avec Show Image.

• Combinez avec Histogram On Line ou Histogram On Curve pour des analyses de profil limitées à la zone recadrée.

• Utilisez les coordonnées du rectangle avec des blocs conscience de la ROI comme Get ROI ou Check Area pour créer une logique en aval basée sur la position d’objets à l’intérieur de la région sélectionnée.

🛠️ Dépannage

• Si les curseurs ne couvrent pas toute l’étendue de l’image, confirmez qu’une image est bien connectée et visible dans l’étiquette Input Image Size (H, W) — les curseurs ne se mettent à jour qu’après réception de l’image.

• Si la sortie recadrée est vide ou noire, assurez-vous que les valeurs min/max des curseurs définissent une aire non nulle et qu’elles sont à l’intérieur des limites de l’image.

• Si les blocs en aval attendent un format de canal spécifique (niveau de gris vs RGB), utilisez une conversion de couleur ou un bloc de prétraitement tel que Image Resizer avant ou après le recadrage pour correspondre au format attendu.