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

# Image Color Match

Ce bloc fonctionnel ajuste la distribution des couleurs d'une image d'entrée pour correspondre à une image de référence. Il est utile lorsque vous souhaitez une apparence des couleurs cohérente entre plusieurs images ou sources caméra.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Image RGB`

* L'image source dont les couleurs seront ajustées.

`Reference Image`

* Optionnel. L'image utilisée comme référence de couleur. Si elle n'est pas fournie, le bloc utilisera l'image source comme référence.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Image Any`

* L'image de sortie avec les couleurs appariées.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

Ce bloc fonctionnel ne possède pas de contrôles interactifs.

## 🎨 Fonctionnalités <a href="#features" id="features"></a>

* Aligne la distribution globale des couleurs entre deux images pour un rendu visuel cohérent.
* Opère par canal de couleur pour un appariement plus fin.
* Retourne une image standard prête pour un traitement ou affichage ultérieur.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Connectez l'image source à `Image RGB`.
2. Facultatif : connectez une image de référence à `Reference Image`. Si omise, la source sera utilisée comme référence.
3. Exécutez le bloc pour obtenir le résultat apparié dans `Image Any`.

## 📊 Évaluation <a href="#evaluation" id="evaluation"></a>

Lors de l'exécution, le bloc compare les statistiques de couleur entre la source et la référence, puis produit une image de sortie dont la distribution des couleurs est alignée sur celle de la référence.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Utilisez `Image Resize` ou `Image Resizer` pour vous assurer que les deux images ont les mêmes dimensions avant de les fournir (une différence de taille provoquera une erreur).
* Utilisez `Color Space` ou `Split Image` et `Merge Channels` si vous souhaitez apparier des canaux spécifiques ou convertir entre représentations colorimétriques avant/après l'appariement.
* Utilisez `Adjust Colors` ou `Normalize Image` pour ajuster le contraste ou la balance des blancs soit avant l'appariement (pour stabiliser l'entrée), soit après (pour un réglage visuel final).
* Prévisualisez les résultats avec `Show Image` et sauvegardez les sorties avec `Image Write` ou `Image Logger` pour documentation ou traitement en aval.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si une erreur liée aux dimensions des images apparaît, assurez-vous que les deux images ont la même largeur et la même hauteur et corrigez les différences avec `Image Resize`.
* Si les couleurs paraissent artificielles après l'appariement, essayez une prétraitement avec `Normalize Image` ou ajustez les valeurs par canal avec `Adjust Colors` avant d'exécuter le bloc.
* Pour traiter par lot un grand nombre d'images, pensez à redimensionner et normaliser les entrées d'abord afin d'obtenir des résultats cohérents sur l'ensemble.