> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/detections-shapes/roi-processing/get-pixel-mouse.md).

# Get Pixel Mouse

Ce bloc fonctionnel vous permet de sélectionner de façon interactive un pixel d'une image en cliquant sur l'image affichée. Il montre la position cliquée sur l'image et fournit la couleur du pixel (ou la valeur en niveaux de gris) ainsi que ses coordonnées.

## 📥 Entrées (sockets) <a href="#inputs" id="inputs"></a>

`Image Any` L'image à afficher et à partir de laquelle vous souhaitez sélectionner un pixel.

## 📤 Sorties (sockets) <a href="#outputs" id="outputs"></a>

`(Blue, Green, Red)` La valeur du pixel échantillonné. Pour les images couleur, il s'agit d'un tuple BGR ; pour les images en niveaux de gris, une valeur mono-canal est renvoyée.

`Point` Les coordonnées du pixel dans l'espace image sous la forme `(x, y)`.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

`Image Display` Zone d'image interactive où vous pouvez cliquer pour sélectionner un pixel.

`Click to Select` Cliquez sur l'image affichée pour choisir un point. Le point sélectionné est marqué visuellement (marqueurs concentriques) afin de confirmer la sélection.

## 🎯 Fonctionnalités <a href="#features" id="features"></a>

* Retour visuel : le pixel sélectionné est mis en évidence directement sur l'image pour visualiser immédiatement l'emplacement de l'échantillonnage.
* Valeur et position : fournit à la fois la couleur/valeur du pixel et ses coordonnées image pour un traitement ultérieur.
* Compatible couleur et niveaux de gris : renvoie un tuple BGR pour les images couleur et une seule valeur pour les images en niveaux de gris.
* Conservation de la dernière sélection : la dernière position cliquée est conservée tant que vous ne choisissez pas un nouveau point, ce qui stabilise l'affichage et les sorties.

## 📝 Comment l'utiliser <a href="#usage" id="usage"></a>

1. Connectez un bloc fonction qui produit une image à l'entrée `Image Any`.
2. L'image apparaîtra dans la zone `Image Display`.
3. Cliquez sur n'importe quel point de l'image affichée pour le sélectionner. La sélection est indiquée par des marqueurs sur l'image.
4. Utilisez les sorties `(Blue, Green, Red)` et `Point` pour alimenter d'autres blocs fonctionnels ou enregistrer la valeur échantillonnée.

## 📊 Ce qui se passe lors de l'exécution <a href="#evaluation" id="evaluation"></a>

Lorsque le bloc s'exécute, il affiche la dernière image reçue sur son entrée. Si vous avez cliqué sur l'image, l'affichage est mis à jour avec un marqueur visuel et la valeur du pixel ainsi que ses coordonnées sont fournies via les sorties.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour prévisualiser ou zoomer l'image avant de cliquer, combinez avec `Show Image` afin d'ouvrir l'image dans un visionneur plus grand et d'inspecter les détails avant l'échantillonnage.
* Si vous ne devez échantillonner qu'une zone spécifique, recadrez d'abord l'image avec `Image ROI Select` ou `Image ROI` puis connectez le résultat recadré à ce bloc.
* Pour annoter les résultats ou marquer les positions échantillonnées sur une image finale, utilisez `Draw Point` ou `Draw Rectangle` après l'échantillonnage.
* Si l'éclairage ou les couleurs rendent l'échantillonnage bruité, essayez un prétraitement avec `Blur`, `Image Threshold` ou `HSV Filter` avant d'alimenter ce bloc pour améliorer la cohérence.
* Pour sauvegarder les images échantillonnées ou les journaux, connectez la sortie image de ce bloc à `Image Logger` ou `Image Write` pour archivage ou rapport.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Aucun marqueur après un clic : vérifiez qu'une image est bien connectée et visible dans le `Image Display`. Sans image, le clic n'a aucun effet.
* Valeurs de pixel inattendues : vérifiez si l'image d'entrée est en couleur ou en niveaux de gris — les images couleur renvoient un tuple BGR, les images gris une seule valeur.
* Coordonnées hors plage : les positions cliquées sont limitées à la zone de l'image affichée. Si vous observez des coordonnées incohérentes, assurez-vous que l'image affichée correspond à la résolution réelle (utilisez `Image Resize` si nécessaire).