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

Get ROI

Cette fonction extrait une région rectangulaire d'une image d'entrée. Utilisez-la lorsque vous souhaitez recadrer une zone spécifique pour une analyse ou une visualisation ultérieure.

📥 Entrées

Image Any Image source à partir de laquelle extraire la région.

Rectangle Coordonnées du rectangle définissant la région à extraire (généralement deux points de coin).

📤 Sorties

Image Any La région recadrée sous forme d'image.

🕹️ Contrôles

Ce bloc fonction n'a pas de widgets interactifs internes. Fournissez le rectangle via une entrée de forme ou provenant d'autres blocs de sélection ROI.

🎨 Fonctionnalités

  • Recadrage rectangulaire simple livré en sortie image pour les blocs en aval.

  • Accepte le rectangle en entrée sous forme de deux coordonnées de coin (par ex., top-left et bottom-right).

  • Gère automatiquement les valeurs de rectangle en dehors des limites de l'image pour éviter les erreurs d'exécution.

📝 Instructions d'utilisation

  1. Connectez l'image source à l'entrée Image Any.

  2. Fournissez un Rectangle décrivant la région à extraire. Celui-ci peut être produit par des blocs de sélection ROI interactifs ou par d'autres blocs qui renvoient des coordonnées de rectangle.

  3. Utilisez la sortie Image Any pour envoyer la région recadrée aux blocs suivants.

📊 Évaluation

Lors de l'exécution, ce bloc retourne l'image contenue dans le rectangle fourni. Si le rectangle dépasse les bords de l'image, la région sera tronquée à la zone valide de l'image.

💡 Astuces

  • Pour une sélection interactive, combinez avec Image ROI Select pour dessiner un rectangle sur la source et branchez sa sortie dans l'entrée Rectangle.

  • Pour extraire plusieurs régions à la fois, utilisez Image ROI Select Multi ou Image ROI Polygon Multi pour générer plusieurs rectangles ou polygones, puis alimentez chaque rectangle dans des instances séparées de ce bloc ou itérez à l'aide de blocs de contrôle de flux.

  • Prévisualisez le résultat recadré en connectant la sortie à Show Image.

  • Utilisez Image Resize ou Image Padding après ce bloc si le bloc en aval requiert une taille d'image spécifique.

  • Pour les flux de travail centrés sur les objets, recadrez d'abord la zone (avec ce bloc) puis exécutez Find Object, Template Match ou Histogram On Line sur la zone extraite pour améliorer la rapidité et réduire les faux positifs.

  • Si vous avez besoin d'un recadrage centré, associez avec Image ROI Center pour générer un rectangle autour d'un point central choisi.

  • Utilisez Draw Rectangle sur un chemin d'affichage pour visualiser le ROI sélectionné sur l'image originale à des fins de vérification.

🛠️ Dépannage

  • Si la sortie est vide ou tronquée de manière inattendue, vérifiez que le Rectangle contient deux coordonnées de coin valides à l'intérieur des limites de l'image.

  • Si le recadrage semble décalé ou inversé, assurez-vous que le rectangle est fourni sous forme de paires top-left et bottom-right (ou l'ordre de coordonnées accepté par votre source ROI).

  • Si vous avez besoin d'un ROI de taille cohérente malgré des résolutions d'image variables, ajoutez Image Resize avant ou après ce bloc pour normaliser les dimensions.

Mis à jour