> 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/transformation-filters/contrast-brightness-gamma.md).

# Contrast-Brightness-Gamma

Ce bloc de fonction permet d'ajuster facilement le contraste, la luminosité et le gamma d'une image à l'aide de trois curseurs simples. Idéal pour un réglage visuel rapide ou comme étape de prétraitement avant une analyse plus approfondie.

## 📥 Entrées (sockets)

* `Image Any` Image d'entrée à ajuster.

## 📤 Sorties (sockets)

* `Image Any` Image ajustée après application du contraste, de la luminosité et du gamma.

## 🕹️ Contrôles

* `Contrast Value` Curseur pour augmenter ou diminuer le contraste de l'image.
* `Brightness Value` Curseur pour éclaircir ou assombrir l'image.
* `Gamma Value` Curseur pour appliquer une correction gamma et ajuster les tons moyens.

## 🎨 Fonctionnalités

* Réglage visuel en temps réel via les curseurs pour des expérimentations rapides.
* Opérations combinées : le contraste et la luminosité sont appliqués en premier, puis la correction gamma pour un contrôle tonal harmonieux.
* Compatible avec tous les formats d'image pris en charge par le système (couleur ou niveaux de gris).

## 📝 Instructions d'utilisation

1. Fournissez une image à la socket `Image Any`.
2. Déplacez le curseur `Contrast Value` pour régler le contraste. Des valeurs positives augmentent le contraste ; des valeurs négatives le diminuent.
3. Déplacez le curseur `Brightness Value` pour éclaircir ou assombrir l'image.
4. Ajustez le curseur `Gamma Value` pour corriger les tons moyens sans trop affecter les extrêmes.
5. L'image traitée est disponible sur la socket de sortie `Image Any` pour prévisualisation ou traitement ultérieur.

## 📊 Évaluation

Lorsque le bloc est exécuté, il produit une image unique ajustée selon la position actuelle des curseurs. Utilisez cette sortie pour alimenter des blocs d'analyse en aval, de visualisation ou d'enregistrement.

## 💡 Astuces et conseils

* Pour les images bruitées, utilisez le bloc `Denoising` avant ce bloc afin d'éviter d'amplifier le bruit en augmentant le contraste.
* Pour des améliorations automatiques, essayez de combiner ce bloc avec `Auto Contrast` pour obtenir une base rapide avant un réglage manuel.
* Pour accélérer le traitement sur des images très grandes, placez un `Image Resizer` en amont pour réduire la résolution avant l'ajustement.
* Utilisez `Show Image` après ce bloc pour inspecter le résultat dans une fenêtre de visualisation plus grande.
* Pour enregistrer les sorties, connectez le résultat à `Image Logger` ou `Image Write` afin de sauvegarder les images ajustées.
* Comme sources d'image en amont, utilisez `Load Image`, `Camera USB` ou `Camera IP (ONVIF)` selon votre flux de travail.

## 🛠️ Dépannage

* Si l'image paraît trop contrastée ou « découpée », réduisez la valeur `Contrast Value` ou diminuez `Brightness Value`, puis réappliquez une correction gamma modérée.
* Si les couleurs semblent étranges après des ajustements importants, essayez `Auto Contrast` ou `Normalize Image` pour rééquilibrer les plages de pixels.
* Si la réactivité en temps réel est lente, réduisez la résolution d'entrée avec `Image Resizer` avant d'effectuer les réglages.