> 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/mean-value-of-image.md).

# Mean Value of Image

Ce bloc fonction calcule l'intensité moyenne des pixels d'une image entrante et affiche le résultat sous forme de nombre entre 0 et 255. Il est utile pour des contrôles rapides de qualité (luminosité), des décisions de prétraitement et une simple supervision.

## 📥 Entrées

* `Image Any` — L'image dont la valeur moyenne des pixels sera calculée.

## 📤 Sorties

* `Mean Value` — L'intensité moyenne calculée des pixels (arrondie), plage 0–255.

## 🕹️ Contrôles

* `Mean value` — Un petit affichage intégré au bloc qui montre la moyenne calculée en temps réel.\
  Ce bloc n'a pas d'autres contrôles modifiables par l'utilisateur.

## 🎨 Fonctionnalités

* Calcul rapide de l'intensité moyenne des pixels pour tout type d'image.
* Retour visuel en direct via l'affichage intégré du bloc.
* Fonctionne avec des images couleur ou niveaux de gris en moyennant tous les canaux/pixels en une seule valeur scalaire.

## 📝 Instructions d'utilisation

1. Connectez n'importe quel bloc produisant une image à l'entrée `Image Any`.
2. Lancez le scénario. Le bloc calculera l'intensité moyenne et mettra à jour l'affichage `Mean value`.
3. Lisez le résultat numérique depuis la sortie `Mean Value` pour la logique en aval ou la journalisation.

## 📊 Évaluation

Lors de l'exécution, le bloc calcule la moyenne sur tous les pixels (et canaux) de l'image fournie et renvoie une valeur numérique (arrondie) représentant la luminosité globale / intensité moyenne.

## 💡 Conseils et astuces

* Utilisez `Blur` avant ce bloc pour réduire l'effet des petites fluctuations bruyantes sur la moyenne.
* Utilisez `Image Threshold` ou `Apply Mask` pour calculer la moyenne uniquement sur les régions de premier plan au lieu de l'image entière.
* Utilisez `Image ROI` ou `Image ROI Select` pour restreindre le calcul à une région d'intérêt (contrôles de luminosité localisés).
* Réduisez le coût de traitement sur les images volumineuses en ajoutant `Image Resizer` avant ce bloc.
* Utilisez `Show Image` en parallèle pour confirmer visuellement à quelle image la valeur moyenne se réfère.
* Combinez avec `Image Memory` pour figer une image d'échantillon et analyser plusieurs fois la même trame pour des comparaisons stables.

## 🛠️ Dépannage

* Si la `Mean Value` est inattendue, vérifiez l'image d'entrée avec `Show Image` pour confirmer la source et le contenu corrects.
* Si aucune valeur n'apparaît, assurez-vous que le bloc producteur d'image fournit bien des données d'image valides. Le bloc attend une entrée de type image.
* Pour des relevés incohérents, essayez de lisser avec `Blur` ou de recadrer la zone d'intérêt avec `Image ROI Select` avant de calculer la moyenne.