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.