> 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/input-output/outputs-exports/multi-image-write.md).

# Multi Image Write

Ce bloc fonction enregistre plusieurs images sur le disque lorsque la condition d'écriture est active. Il prend en charge une compression optionnelle et accepte un chemin de dossier ainsi qu'un modèle de nom de fichier pour organiser les fichiers sauvegardés.

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

`Folder Path` socket d'entrée\
Fournissez le chemin complet du dossier où les images seront enregistrées.

`File Name` socket d'entrée\
Fournissez le nom de base du fichier (sans extension). Vous pouvez utiliser un horodatage ou un texte personnalisé.

`Write Condition` socket d'entrée\
Déclencheur booléen qui lance l'opération d'enregistrement lorsque True.

`Input Images` socket d'entrée\
Accepte une ou plusieurs images (liste). Chaque image sera sauvegardée dans un fichier séparé.

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

Ce bloc fonction ne produit aucune sortie.

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

`Compress Image?` Case à cocher\
Lorsque activée, les images sont enregistrées au format JPEG avec une qualité réduite pour diminuer la taille des fichiers. Lorsque désactivée, les images sont enregistrées en PNG (sans perte).

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

* Enregistrer plusieurs images en une seule action.
* Compression JPEG optionnelle pour réduire l'utilisation d'espace.
* Chemin de dossier et nom de fichier de base personnalisables pour organiser les fichiers.
* Journalisation des messages de succès ou d'erreur pour chaque fichier enregistré.

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

1. Indiquez un chemin dans `Folder Path` (ou utilisez un bloc de sélection de dossier en amont).
2. Définissez un nom de base dans `File Name`. Utilisez une chaîne temporelle ou un compteur pour éviter les collisions.
3. Connectez un signal booléen à `Write Condition` ; mettez-le sur True pour déclencher l'enregistrement.
4. Alimentez une ou plusieurs images dans `Input Images`. Chaque image sera écrite sur le disque avec le nom de base et un suffixe d'index.
5. Activez ou désactivez `Compress Image?` selon que vous préfériez la compression JPEG ou le PNG.

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

Lorsque `Write Condition` est True et que les entrées sont valides, le bloc tente d'enregistrer chaque image de la liste fournie. Les enregistrements réussis sont consignés ; les échecs retournent une erreur (par exemple si le dossier est invalide ou si l'écriture sur disque échoue).

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

* Utilisez `Choose Folder` pour permettre aux utilisateurs de sélectionner le dossier de sauvegarde de façon interactive et connectez sa sortie à `Folder Path`.
* Combinez avec `Date-Time` pour générer automatiquement des noms de fichiers uniques (par ex. horodatage dans `File Name`).
* Si vous souhaitez prévisualiser les images avant de les sauvegarder, envoyez-les d'abord vers `Show Image`.
* Réduisez la taille des images avant sauvegarde pour économiser de l'espace et accélérer les écritures en utilisant `Image Resize` ou `Image Resizer` en amont.
* Pour enregistrer plusieurs images liées en une seule vue récapitulative, créez un montage avec `Collage Images` puis enregistrez le collage.
* Si vous avez besoin d'une journalisation continue des images, associez-le à `Image Logger` pour des flux d'archivage automatiques.

## 🛠️ Résolution des problèmes <a href="#troubleshooting" id="troubleshooting"></a>

* Erreurs de dossier invalide : vérifiez que `Folder Path` existe et est accessible en écriture. Utilisez `Choose Folder` pour éviter les erreurs de saisie.
* Aucune image sauvegardée : assurez-vous que `Input Images` est connecté et que `Write Condition` est True au moment de l'évaluation.
* Fichiers corrompus ou formats inattendus : basculez `Compress Image?` pour passer entre JPEG et PNG et vérifiez la compatibilité en aval.
* Grand nombre d'images ralentit le système : redimensionnez les images avec `Image Resize` avant l'écriture ou activez la compression pour réduire les E/S disque.