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

# Contrast Optimization

Ce bloc de fonction améliore le contraste local des images en utilisant une technique d'egalisation d'histogramme adaptative avec limitation de contraste (CLAHE). Il est utile lorsque des détails sont cachés dans des zones de luminosité similaire et que vous souhaitez les rendre plus visibles sans amplifier excessivement le bruit.

## 📥 Entrées

`Image Any` — L'image d'entrée dont le contraste doit être amélioré. Fonctionne avec des images en couleur ou en niveaux de gris.

## 📤 Sorties

`Image Any` — L'image de sortie avec le contraste amélioré.

## 🕹️ Contrôles

`Grid Size` — Ajuste la taille de la grille locale utilisée pour l'égalisation du contraste. Des valeurs plus élevées créent des tuiles plus grandes et des ajustements locaux plus grossiers.

`Clip Limit` — Contrôle la force de la limitation du contraste pour éviter une amplification excessive du bruit. Des valeurs plus élevées augmentent la quantité d'amélioration du contraste.

## 🎨 Fonctionnalités

* Améliore les détails locaux dans les ombres et les hautes lumières tout en empêchant une forte amplification du bruit.
* Fonctionne sur les images couleur en appliquant l'amélioration sur le canal de luminosité (lightness) tout en préservant la couleur.
* Des curseurs interactifs permettent d'ajuster le bloc en temps réel pour votre scène.

## 📝 Instructions d'utilisation

1. Connectez une source d'image à `Image Any`.
2. Ajustez `Grid Size` pour contrôler l'échelle des zones locales de contraste.
3. Réglez `Clip Limit` pour contrôler l'intensité de l'amélioration.
4. Observez le résultat sur la sortie `Image Any` et affinez les curseurs si nécessaire.

## 📊 Évaluation

À l'exécution, ce bloc traite l'image entrante et produit une image améliorée qui révèle les différences de contraste local tout en limitant l'augmentation du bruit.

## 💡 Astuces

* Pour les très grandes images, utilisez `Image Resizer` pour réduire la taille d'entrée avant d'exécuter ce bloc afin d'accélérer le traitement.
* Si le résultat paraît bruyant, essayez `Denoising` avant d'appliquer ce bloc, puis comparez avec l'original.
* Pour prévisualiser les résultats pendant la construction du flux, connectez la sortie à `Show Image`.
* Si vous ne souhaitez améliorer qu'une zone spécifique, recadrez d'abord avec `Image ROI` puis appliquez ce bloc.
* Combinez avec `Auto Contrast` ou `Normalize Image` pour comparer l'amélioration globale versus locale et choisir le meilleur résultat pour votre application.
* Enregistrez les images finales avec `Image Write` ou consignez plusieurs résultats avec `Image Logger`.

## 🛠️ Dépannage

* Si les images semblent trop saturées ou bruyantes, réduisez la valeur de `Clip Limit` ou prétraitez avec `Denoising`.
* Si de très petits détails disparaissent, augmentez `Grid Size` pour éviter des ajustements trop locaux.
* Si le traitement est lent, réduisez la taille de l'image avec `Image Resizer` avant de l'envoyer dans ce bloc.