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

# Image Write

Ce bloc de fonction enregistre des images d'entrée sur le disque lorsque la condition d'enregistrement est active. Il prend en charge la compression optionnelle (JPEG) et la nomination automatique, et est conçu pour faciliter l'export d'images capturées ou traitées.

## 📥 Entrées

`Folder Path`\
Chemin complet du dossier où l'image sera enregistrée. Si laissé vide, le dossier de travail courant est utilisé.

`File Name`\
Nom de fichier optionnel sans extension. Si laissé vide, un nom basé sur un horodatage est utilisé automatiquement.

`Save`\
Déclencheur booléen qui contrôle si l'image sera écrite sur le disque. Fournissez TRUE pour enregistrer, FALSE pour empêcher l'enregistrement.

`Input Image`\
Image à enregistrer. Accepte tout format d'image courant provenant des blocs précédents.

## 📤 Sorties

Ce bloc de fonction ne fournit pas de sorties via des connecteurs. Il rapporte son statut via des messages de log visibles dans l'interface utilisateur.

## 🕹️ Contrôles

`Compress Image`\
Case à cocher pour basculer l'enregistrement en fichier JPEG compressé au lieu d'un PNG non compressé. Utilisez la compression pour réduire la taille des fichiers si l'espace disque ou la bande passante est limité.

## 🎨 Fonctionnalités

* Enregistrement à la demande via l'entrée booléenne `Save`.
* Nom de fichier automatique basé sur l'horodatage si aucun nom n'est fourni.
* Option pour enregistrer en JPEG (compressé) ou PNG (sans perte).
* Messages de log informatifs confirmant la réussite ou reportant les erreurs (dossier manquant, permissions, image manquante).
* Contrôle simple dans l'interface pour activer/désactiver la compression.

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

Lorsque l'entrée `Save` est active (TRUE), le bloc tente d'écrire l'`Input Image` actuelle vers le chemin défini par `Folder Path` et `File Name`. Si `Compress Image` est cochée, l'image est enregistrée en JPEG pour réduire la taille ; sinon elle est enregistrée en PNG. Si le dossier n'existe pas ou si l'image est manquante, le bloc enregistre une erreur au lieu d'écrire le fichier.

## 📝 Instructions d'utilisation

1. Indiquez une destination via l'entrée `Folder Path` ou laissez vide pour utiliser le dossier par défaut.
2. Facultativement, définissez un `File Name` ou laissez vide pour utiliser un nom automatique horodaté.
3. Alimentez l'image que vous souhaitez enregistrer dans la prise `Input Image`.
4. Activez l'entrée `Save` (par exemple avec un déclencheur manuel ou programmatique) pour écrire le fichier.
5. Utilisez la case `Compress Image` pour choisir entre JPEG (plus petit) ou PNG (sans perte).

## 💡 Astuces et bonnes pratiques

* Utilisez `Choose Folder` pour permettre aux utilisateurs de sélectionner le dossier cible de manière interactive avant l'enregistrement.
* Combinez avec `String Input` ou `Date-Time` pour construire des noms de fichiers descriptifs et horodatés.
* Prévisualisez l'image avec `Show Image` avant d'enregistrer pour vérifier le contenu.
* Si les images sont volumineuses, ajoutez `Image Resizer` avant ce bloc pour réduire la taille et améliorer le débit.
* Utilisez `Image ROI Select` ou `Draw Result On Image` pour recadrer ou annoter les images avant l'enregistrement (par ex. sauvegarder uniquement les régions détectées ou les résultats superposés).
* Pour un enregistrement à haut débit, envisagez `Image Logger` ou `Record Video` au lieu d'enregistrer des images individuelles à chaque déclenchement.

## 🛠️ Résolution des problèmes

* Dossier inexistant ou erreur de permission : vérifiez le chemin fourni dans `Folder Path` et utilisez `Choose Folder` pour éviter les fautes de frappe.
* Erreur "No image data available" : assurez-vous que la prise `Input Image` reçoit des données d'image valides avant d'envoyer le déclencheur `Save`. Prévisualisez avec `Show Image` pour confirmer.
* Fichiers volumineux ou sauvegardes lentes : activez `Compress Image` ou insérez `Image Resizer` pour réduire la résolution avant l'enregistrement.
* Noms de fichiers inattendus : incluez `Date-Time` ou un `String Input` personnalisé pour générer des noms uniques et éviter les écrasements.

Si vous enregistrez de manière répétée à intervalles très courts, assurez-vous que le stockage cible dispose d'un espace libre et d'une performance d'écriture suffisante pour votre scénario.