> 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/image-transformations/analysis/image-resolution-and-channel-value.md).

# Image Resolution and Channel Value

Ce bloc de fonction rapporte des informations de base sur la taille et les canaux d'une image d'entrée. Il est utile pour vérifier rapidement les dimensions de l'image avant d'appliquer un traitement ou d'envoyer des données à d'autres blocs.

## 📥 Entrées

`Image Any` — Prise d'entrée d'image. Fournissez n'importe quelle image (couleur ou niveaux de gris) à analyser.

## 📤 Sorties

`Width` — Largeur de l'image d'entrée en pixels (nombre).

`Height` — Hauteur de l'image d'entrée en pixels (nombre).

`Channel` — Nombre de canaux de l'image d'entrée (par ex. 1 pour niveaux de gris, 3 pour RGB).

## 🕹️ Contrôles

`Resolution` — Étiquette affichée sur le bloc indiquant de manière lisible la largeur, la hauteur et le nombre de canaux de l'image.

## 🎯 Fonctionnalités

* Extraction rapide des métadonnées : renvoie instantanément la largeur, la hauteur et le nombre de canaux lorsque une image est présente sur la prise d'entrée.
* Prise en charge niveaux de gris et couleur : reconnaît les images à un seul canal et les images multi-canaux et rapporte le nombre de canaux en conséquence.
* Retour visuel : l'étiquette `Resolution` sur le bloc affiche le résultat actuel pour une inspection rapide.

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

Lorsque ce bloc s'exécute, il inspecte l'image fournie sur la prise d'entrée `Image Any`, détermine ses dimensions en pixels et le nombre de canaux, met à jour l'étiquette `Resolution` sur le bloc, et envoie les valeurs numériques via les sorties `Width`, `Height` et `Channel` pour que les blocs en aval puissent les utiliser.

## 📝 Utilisation

* Connectez un bloc producteur d'images à la prise d'entrée `Image Any` (par exemple `Camera USB`, `Camera IP (ONVIF)` ou `Load Image`).
* Lisez l'étiquette `Resolution` pour un résumé rapide.
* Utilisez les sorties numériques `Width`, `Height` et `Channel` pour piloter la logique, les choix de prétraitement ou afficher des informations dans d'autres blocs.

## 💡 Conseils et Astuces

* Pour vérifier visuellement l'image tout en inspectant sa taille, connectez la même source d'image à `Show Image` afin de prévisualiser les images tout en lisant les dimensions.
* Si vous n'avez besoin que d'une région spécifique, utilisez `Image ROI Select` avant ce bloc pour mesurer la résolution de la zone recadrée plutôt que celle de l'image entière.
* Pour analyser plus finement l'information couleur, combinez ce bloc avec `Split Image` pour séparer les canaux ou avec `Merge Channels` après des ajustements personnalisés.
* Utilisez `Image Memory` lorsque vous travaillez avec une image de test statique afin que les valeurs rapportées restent stables pendant que vous ajustez d'autres étapes de traitement.

(hint) Combinez ce bloc en début de chaîne de traitement pour prendre des décisions adaptatives (par exemple choisir un algorithme approprié ou une stratégie de redimensionnement) en fonction de la taille réelle de l'image et du nombre de canaux.

## 🛠️ Dépannage

* Pas de sortie de données : assurez-vous qu'un bloc producteur d'images est connecté à la prise `Image Any` et qu'il fournit effectivement des images.
* Nombre de canaux inattendu : certaines images en niveaux de gris n'ont qu'un seul canal alors que les images couleur en ont trois. Si vous avez besoin d'un autre format de canaux, utilisez `Split Image` et `Merge Channels` ou des blocs de conversion de couleur avant ce bloc.
* Tailles d'image très grandes ralentissant le flux : redimensionnez en amont avec `Image Resizer` pour réduire la charge de traitement avant d'envoyer les images vers des blocs gourmands en calcul.