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

# Collage Images

Ce bloc de fonction crée une seule image en mode collage à partir de plusieurs images d'entrée. Si une liste de drapeaux correspondante (OK/NOK) est fournie, le collage ajoute des bordures colorées à chaque vignette pour indiquer l'état.

## 📥 Entrées

* `Image List`\
  Une liste d'images à combiner dans le collage (les images peuvent avoir des tailles différentes).
* `Flag List`\
  Liste optionnelle de drapeaux booléens ou d'état (OK/NOK) correspondant à chaque image de la `Image List`. Si fournie, chaque vignette affichera une bordure colorée indiquant l'état.

## 📤 Sorties

* `Collaged Image`\
  L'image résultante combinée créée à partir de la liste d'entrées.

## 🕹️ Contrôles

* `Select Image Size (Pixel)`\
  Utilisez ce curseur pour définir la taille des tuiles utilisées dans la mise en page du collage. Des valeurs plus élevées produisent des vignettes plus grandes et un collage final plus grand.

## 🎨 Fonctionnalités

* Fusion simple de nombreuses images en une seule image d'aperçu, utile pour des rapports, tableaux de bord ou inspections rapides.
* Support optionnel de marquage (flagging) pour indiquer visuellement chaque vignette comme OK ou NOK via des bordures.
* Taille de tuile ajustable pour équilibrer le niveau de détail et les dimensions finales du collage.
* Accepte des sources d'images mixtes (images camera, découpes traitées, images enregistrées).

## ⚙️ Fonctionnement

Quand le bloc est exécuté, il lit la `Image List` fournie et, optionnellement, la `Flag List`. Il redimensionne ou met en tuiles les images selon la valeur choisie de `Select Image Size (Pixel)` et les arrange en grille. Si des flags sont présents et correspondent au nombre d'images, chaque vignette reçoit une bordure colorée indiquant son état OK/NOK. L'image combinée finale est envoyée via la sortie `Collaged Image`.

## 📝 Instructions d'utilisation

1. Préparez les images à combiner et fournissez-les à l'entrée `Image List`.
2. Facultatif : fournissez une `Flag List` de même longueur pour ajouter des bordures d'état.
3. Ajustez `Select Image Size (Pixel)` pour modifier la taille des vignettes selon lisibilité ou compacité.
4. Connectez la sortie `Collaged Image` à un bloc d'affichage ou d'enregistrement pour inspecter ou sauvegarder le résultat.

## 💡 Astuces

* Normalisez les tailles d'entrée pour un collage plus esthétique : utilisez `Image Resize` ou `Image Resizer` avant d'alimenter la `Image List`.
* Pour collecter plusieurs régions découpées d'une même source, utilisez `Image ROI Select Multi` pour construire la `Image List`.
* Générez les flags automatiquement en combinant des blocs de détection comme `Mask Detection`, `Object Detection` ou `Object Detection - Custom`. Utilisez les résultats de détection (logique OK/NOK) pour composer la `Flag List`.
* Prévisualisez le collage en temps réel en connectant la sortie à `Show Image`.
* Sauvegardez automatiquement les collages avec `Multi Image Write` ou consignez-les avec `Image Logger` pour traçabilité.
* Si vous utilisez beaucoup d'images, réduisez `Select Image Size (Pixel)` pour conserver une taille finale adaptée à l'affichage ou à l'enregistrement.

## 🛠️ Résolution de problèmes

* Si des bordures semblent manquer ou être incorrectes, vérifiez que la longueur de la `Flag List` est égale à celle de la `Image List`.
* Si les images apparaissent étirées ou recadrées de façon inattendue, ajoutez une étape `Image Resize` pour standardiser les rapports d'aspect avant de créer le collage.
* Si le collage est trop volumineux pour l'affichage ou l'enregistrement, diminuez la valeur de `Select Image Size (Pixel)`.