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

# Add Images Weighted

Ce bloc de fonction fusionne deux images en utilisant un poids défini par l'utilisateur. Il est utile pour créer des superpositions douces, des fondus enchaînés ou un mélange contrôlé de deux sources visuelles.

## 📥 Entrées

* `Image Any` Première image en entrée à fusionner.
* `Image Any` Deuxième image en entrée à fusionner.

## 📤 Sorties

* `Image Any` Image résultante fusionnée.

## 🕹️ Contrôles

* `Weight %` Curseur qui définit l'influence de la première image dans le mélange. Les valeurs faibles favorisent la deuxième image, les valeurs élevées favorisent la première image.

## ⚙️ Mécanisme d'exécution

Lorsque le bloc s'exécute, il prend les deux images d'entrée et mélange leurs valeurs de pixels selon le `Weight %` choisi. Si les deux images ont des tailles différentes, le bloc ajustera la deuxième image pour correspondre à la première afin de permettre la fusion. Les valeurs de pixels finales sont plafonnées dans la plage valide de l'image pour éviter les artefacts visuels.

## 🎯 Fonctionnalités

* Fusion en temps réel contrôlée par un seul curseur facile à utiliser.
* Ajustement automatique de la taille lorsque les entrées diffèrent en résolution.
* Clamp sécurisé des valeurs pour garantir une sortie d'image valide.
* Fonctionne avec n'importe quel bloc produisant des images tant que des données d'image sont fournies.

## 📝 Instructions d'utilisation

1. Fournissez deux sources d'image aux entrées `Image Any`.
2. Ajustez le curseur `Weight %` pour définir le ratio de mélange entre les deux images.
3. Lisez l'image fusionnée depuis la sortie `Image Any` et transmettez-la pour un traitement ou un affichage ultérieur.

## 💡 Conseils et astuces

* Si vos images ont des tailles différentes, utilisez `Image Resizer` ou `Image Resize` avant ce bloc pour contrôler la méthode de redimensionnement (préserver le ratio, méthode d'interpolation, etc.).
* Pour éviter des jointures visibles lors du mélange d'images capturées sous un éclairage différent, appliquez `Normalize Image` ou `Contrast Optimization` aux deux entrées en amont.
* Utilisez `Blur` sur une entrée pour créer des transitions douces ou des superpositions de type profondeur de champ.
* Si vous avez besoin d'une addition simple sans pondération, envisagez d'utiliser le bloc `Add Images`.
* Prévisualisez les résultats avec `Show Image` pendant l'ajustement du `Weight %` pour accélérer les réglages visuels.
* Pour combiner de nombreuses images, chaînez ce bloc avec `Add Images Weighted` à plusieurs reprises ou utilisez des blocs de concaténation d'images comme étape intermédiaire.

## 🛠️ Dépannage

* Si la sortie semble étirée ou recadrée : vérifiez que les deux entrées ont les dimensions attendues ; pensez à insérer un `Image Resizer` pour expliciter les tailles.
* Si le résultat paraît saturé ou trop lumineux : appliquez `Normalize Image` ou réduisez les extrêmes du poids de fusion.
* Si aucune image n'apparaît : assurez-vous que les blocs amont fournissent des données d'image valides. Utilisez un bloc d'affichage comme `Show Image` pour vérifier chaque entrée.
* Si la fusion est lente avec de grandes images : réduisez la taille d'entrée avec `Image Resizer` avant la fusion pour améliorer les performances.