> 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/image-concatenate.md).

# Image Concatenate

Ce bloc de fonction fusionne plusieurs images en une seule en les plaçant côte à côte (horizontal) ou les unes après les autres (vertical). Il aligne automatiquement les images en ajoutant des bordures lorsque les images d'entrée ont des dimensions différentes, pour obtenir une image de sortie propre et cohérente.

## 📥 Entrées

* `Image List` — socket d'entrée qui accepte une ou plusieurs images à concaténer (prise en charge de plusieurs images).

## 📤 Sorties

* `Image` — socket de sortie fournissant l'image concaténée.

## 🕹️ Contrôles

* `Relation` — menu déroulant pour choisir la direction de concaténation.
  * Sélectionnez HORIZONTAL ou VERTICAL.

## 🎯 Caractéristiques principales

* Alignement automatique : lorsque les images d'entrée diffèrent en largeur ou en hauteur, le bloc ajoute des bordures pour harmoniser les tailles et aligner correctement les images.
* Prise en charge de plusieurs entrées : fournissez une liste d'images et le bloc produira une image combinée unique.
* Changement d'orientation simple : basculez entre concaténation horizontale et verticale via le contrôle `Relation`.

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

À l'exécution, le bloc lit la `Image List` fournie, s'assure que chaque image a des dimensions compatibles en ajoutant des bordures si nécessaire, puis les fusionne selon la valeur de `Relation`. L'image résultante est envoyée sur la sortie `Image` pour affichage ou traitement ultérieur.

## 📝 Utilisation

1. Fournissez les images dans l'entrée `Image List` — vous pouvez connecter plusieurs blocs produisant des images ou une liste d'images.
2. Sélectionnez la mise en page souhaitée avec le menu `Relation`.
3. Récupérez le résultat combiné depuis la sortie `Image` et utilisez-le pour l'affichage, la journalisation ou un traitement ultérieur.

## 💡 Astuces

* Pour obtenir des résultats homogènes sans bordures visibles, utilisez `Image Resizer` ou `Image Resize` avant ce bloc pour mettre toutes les images à la même taille.
* Pour contrôler la couleur de remplissage ou ajouter des marges personnalisées, préparez les images avec `Image Padding` avant la concaténation.
* Rognez les entrées sur les régions exactes à combiner avec `Image ROI Select` ou `Image ROI` avant de les fournir au bloc.
* Utilisez `Show Image` pour prévisualiser interactivement le résultat concaténé.
* Pour enregistrer ou archiver la sortie combinée, connectez la sortie `Image` à `Image Logger` ou `Image Write`.
* Si vous souhaitez un style de collage avec des bordures indiquant des états OK/NOK, envisagez `Collage Images` en alternative.

## 🛠️ Dépannage

* Bordures noires inattendues : les images ont des rapports d'aspect différents. Acceptez les bordures ou utilisez `Image Resizer` / `Image Padding` / `Image ROI Select` pour standardiser les tailles d'entrée.
* Sortie vide ou manquante : vérifiez que chaque élément de `Image List` est une image valide. Placez un bloc de prévisualisation en amont (`Show Image`) pour vérifier les entrées.
* Sortie très haute ou très large : choisissez `Relation` VERTICAL ou HORIZONTAL de façon appropriée, ou redimensionnez les entrées à une dimension gérable avant la concaténation.