> 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/operations/add-images.md).

# Add Images

Ce bloc de fonction combine deux images en additionnant les valeurs de leurs pixels. C'est une méthode simple et rapide pour fusionner la luminosité ou superposer le contenu d'images, utile lorsque vous voulez la somme directe de deux images plutôt qu'une moyenne fondue.

## 📥 Entrées

`Image Any` Première image d'entrée à additionner.

`Image Any` Deuxième image d'entrée à additionner.

## 📤 Sorties

`Image Any` Image résultante après addition pixel par pixel (les valeurs sont maintenues dans la plage d'affichage valide).

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles interactifs.

## ⚙️ Fonctionnement

* Le bloc lit les deux images fournies et produit une nouvelle image en combinant les valeurs de pixels des deux entrées, pixel par pixel.
* Les valeurs de pixels résultantes sont maintenues dans la plage d'affichage valide afin que la sortie reste affichable.
* Pour de meilleurs résultats, les deux images d'entrée doivent avoir la même résolution et le même nombre de canaux (par ex. toutes les deux RGB ou toutes les deux en niveaux de gris). Si elles diffèrent, préparez d'abord les images (voir "Tips and Tricks").

## ⭐ Caractéristiques

* Combinaison très rapide pixel par pixel — utile pour des superpositions simples, l'accumulation de luminosité ou la fusion de calques visuels.
* Produit une unique image en sortie qui peut être affichée ou traitée par d'autres blocs.
* Fonctionne avec tous les formats d'image supportés par le système, tant que les entrées sont compatibles.

## 📝 Mode d'emploi

1. Connectez la première source d'image à la première entrée `Image Any`.
2. Connectez la seconde source d'image à la seconde entrée `Image Any`.
3. Lisez l'image combinée depuis la sortie `Image Any` et envoyez-la vers un bloc d'affichage, d'analyse ou d'enregistrement.

## 💡 Astuces et conseils

* Si vous souhaitez un mélange pondéré plutôt qu'une somme directe, utilisez le bloc Add Images Weighted.
* Si les entrées ont des tailles différentes, utilisez Image Resizer ou Image Resize pour harmoniser leurs dimensions avant d'additionner. Image Padding peut aussi être utilisé pour aligner les images sans mise à l'échelle.
* Pour éviter la perte de détails due à la saturation des zones très lumineuses (clipping), essayez Normalize Image ou Contrast Optimization après l'addition.
* Appliquez Blur ou Denoising sur les entrées avant l'addition si le bruit d'entrée provoque des artefacts indésirables.
* Si les canaux diffèrent (par ex. une image en niveaux de gris et l'autre en RGB), utilisez Split Image / Merge Channels pour convertir ou adapter les canaux afin qu'ils correspondent.
* Prévisualisez les résultats avec Show Image et enregistrez les sorties avec Image Logger ou Image Write pour archivage.

## 🛠️ Problèmes courants et solutions

* Problème : La sortie semble surexposée ou saturée.\
  Remède : Utilisez Add Images Weighted pour contrôler la contribution de chaque image, ou appliquez Normalize Image / Contrast Optimization sur le résultat.
* Problème : Les entrées ont des tailles ou rapports d'aspect différents.\
  Remède : Harmonisez les tailles avec Image Resizer ou Image Resize avant de les connecter à ce bloc.
* Problème : Incompatibilité de canaux (RGB vs niveaux de gris).\
  Remède : Convertissez les canaux avec Split Image et Merge Channels, ou assurez-vous que les deux sources fournissent le même format de canal.
* Problème : Bruit ou artefacts inattendus après l'addition.\
  Remède : Appliquez Blur ou Denoising aux entrées avant l'addition ; envisagez aussi d'ajuster l'exposition des images sources via les réglages de la caméra ou un prétraitement.

Utilisez ce bloc lorsque vous avez besoin d'une somme pixel par pixel simple. Pour un fondu plus contrôlé ou pour éviter la saturation, préférez Add Images Weighted ou ajoutez une étape de normalisation/optimisation du contraste dans la chaîne de traitement.