> 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.md).

# Get Pixel

Ce bloc fonction lit la valeur couleur à une coordonnée spécifique d'une image et la renvoie pour une utilisation ultérieure. Il prend en charge les images couleur (BGR) et en niveaux de gris et vérifie la coordonnée fournie avant l'échantillonnage.

## 📥 Entrées

`Image Any` Image principale à partir de laquelle effectuer l'échantillonnage

`Point` Coordonnée du pixel à lire (format : (x, y))

## 📤 Sorties

`(Blue, Green, Red)` Valeur du pixel lue à la coordonnée donnée.

* Pour les images couleur, ce sont les canaux B, G, R renvoyés ensemble.
* Pour les images en niveaux de gris, une seule valeur (canal unique) est renvoyée.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles ou de widgets interactifs.

## 🎨 Fonctionnalités

* Échantillonnage simple d'un pixel par coordonnée.
* Fonctionne avec les images couleur (BGR) et en niveaux de gris.
* Validation des entrées avec messages d'erreur clairs si l'image est invalide ou si la coordonnée est hors des limites.
* Renvoie des valeurs dans un format prêt à être connecté à d'autres blocs acceptant des données de pixel ou numériques.

## ⚙️ Mécanisme d'exécution

* Le bloc lit l'image depuis la première prise d'entrée et la coordonnée depuis la seconde prise.
* Si l'image ou la coordonnée est invalide, le bloc signale une erreur pour vous aider à corriger les entrées.
* Si tout est valide, le bloc échantillonne le pixel à la position (x, y) donnée et envoie les valeurs de ses canaux en sortie.

## 📝 Instructions d'utilisation

1. Connectez un bloc producteur d'image à l'entrée `Image Any`.
2. Fournissez une coordonnée à l'entrée `Point`. Les coordonnées sont au format (x, y).
3. Utilisez la sortie `(Blue, Green, Red)` là où c'est nécessaire (affichage, comparaison, journalisation, etc.).

## 💡 Astuces

* Combinez avec `Get Pixel Mouse` pour choisir des coordonnées de manière interactive en cliquant sur l'image.
* Utilisez `Show Image` pour prévisualiser l'image pendant que vous choisissez les coordonnées d'échantillonnage.
* Visualisez l'emplacement d'échantillonnage en envoyant la coordonnée vers `Draw Point` pour confirmer que le bon pixel est lu.
* Recadrez l'image d'abord avec `Image ROI` ou `Image ROI Select` pour limiter l'échantillonnage à une région d'intérêt et éviter les coordonnées hors limites.
* Vérifiez qu'un point se trouve à l'intérieur d'une zone sélectionnée en utilisant `Check Area` avant l'échantillonnage pour éviter les erreurs.
* Enregistrez ou exportez les valeurs échantillonnées avec `Image Logger` ou `CSV Export` pour une analyse ultérieure.

## 🛠️ Dépannage

* Si vous voyez une erreur concernant l'entrée d'image, assurez-vous que le bloc connecté fournit bien une image et que les données ne sont pas vides.
* Si vous voyez une erreur concernant la coordonnée, vérifiez que les valeurs (x, y) sont des entiers et se situent dans la largeur et la hauteur de l'image.
* Lors de l'échantillonnage d'une image en niveaux de gris, attendez-vous à une valeur mono-canal plutôt qu'à trois valeurs de canaux.