For the complete documentation index, see llms.txt. This page is also available as Markdown.

Image Logger

Ce bloc fonction enregistre les images entrantes sur le disque avec un nom de fichier, un format et des limites de stockage configurables. Utilisez-le pour capturer et archiver des images lorsqu'un signal de déclenchement est reçu, ou pour sauvegarder périodiquement des images pour inspection.

📥 Entrées

Folder Path - Dossier de destination où les images seront sauvegardées. Fournissez un chemin valide.

File Name - Nom de fichier optionnel. Si vide, un nom basé sur un horodatage sera utilisé.

Image Limit - Nombre maximal optionnel d'images à conserver dans le dossier. Lorsque la limite est dépassée, les images les plus anciennes sont supprimées.

Input Image - Données d'image à sauvegarder. Connectez n'importe quel bloc produisant une image à cette entrée.

Trigger - Déclencheur booléen qui contrôle l'enregistrement. Lorsque la condition du déclencheur est active, l'image sera écrite selon les paramètres configurés.

📤 Sorties

Ce bloc fonction ne produit aucune sortie.

🕹️ Contrôles

Save Mode - Contrôle déroulant permettant de choisir entre Full Size (PNG) et Compressed (JPEG). Le mode compressé réduit la taille des fichiers au détriment de la qualité.

🎨 Fonctionnalités

  • Nom automatique basé sur l'horodatage lorsque File Name n'est pas fourni.

  • Compression d'image optionnelle pour réduire l'utilisation du disque.

  • Limite du nombre d'images dans le dossier avec suppression automatique des fichiers les plus anciens.

  • Compatible avec toute source d'image entrante (caméras, chargeurs, ou images traitées).

  • Messages d'information et d'erreur clairs lors des succès ou échecs de sauvegarde.

📝 Instructions d'utilisation

  1. Définissez la destination en fournissant Folder Path ou utilisez un bloc qui la fournit.

  2. Facultativement, fournissez un File Name ; laissez vide pour utiliser un nom automatique basé sur l'horodatage.

  3. Facultativement, définissez Image Limit pour contrôler le nombre d'images conservées dans le dossier.

  4. Connectez une source d'image à Input Image.

  5. Utilisez Trigger pour contrôler quand les images sont écrites. Activez le déclencheur pour sauvegarder l'image courante.

  6. Choisissez le Save Mode souhaité pour une sortie PNG ou JPEG compressée.

📊 Évaluation

Quand le bloc reçoit une Input Image valide et que la condition Trigger est satisfaite, il tente de sauvegarder l'image dans le Folder Path fourni en utilisant le Save Mode choisi. Si le dossier contient plus d'images que la valeur de Image Limit, les fichiers les plus anciens sont supprimés pour respecter la limite. Des messages d'information indiquent le succès ; des messages d'erreur expliquent les échecs (chemin invalide, permissions d'écriture, etc.).

💡 Astuces

  • Utilisez Choose Folder pour permettre aux utilisateurs de sélectionner visuellement le dossier cible et l'alimenter dans Folder Path.

  • Combinez Date-Time (horodatage) avec File Name pour créer des noms lisibles et triables chronologiquement.

  • Prévisualisez les images avant sauvegarde en envoyant la même image vers Show Image pour inspecter visuellement les images.

  • Réduisez l'utilisation du disque en ajoutant un Image Resizer avant ce bloc pour réduire la taille des images très volumineuses avant sauvegarde.

  • Pour capturer depuis des sources en direct, combinez avec Camera USB, Camera IP (ONVIF) ou Stream Reader comme fournisseur d'images pour archiver des images provenant de caméras ou de flux.

  • Si vous avez besoin de métadonnées structurées avec les fichiers, envoyez les sorties de détection/mesure vers CSV Export pour consigner des détails (nom de fichier, horodatage, compteurs).

  • Utilisez File/Folder Operations pour créer des dossiers ou gérer les fichiers sauvegardés de manière programmatique avant ou après la journalisation.

  • Pour des flux qui écrivent plusieurs images à la fois, considérez les blocs Multi Image Write ou Image Write comme alternatives si vous avez besoin d'un nommage ou d'un comportement de déclenchement différent.

🛠️ Dépannage

  • Erreurs de dossier invalide : vérifiez que Folder Path existe et que l'application a les permissions d'écriture. Utilisez File/Folder Operations pour créer les dossiers requis en amont.

  • Aucune image sauvegardée : vérifiez que Input Image est connecté et que Trigger est actif au moment attendu.

  • Trop de fichiers accumulés : définissez une valeur raisonnable pour Image Limit ou exécutez une routine de nettoyage avec File/Folder Operations.

  • Fichiers volumineux ralentissant la sauvegarde : passez le Save Mode en Compressed ou ajoutez un Image Resizer en amont.

  • Si les noms de fichiers entrent en collision, incluez un horodatage (via Date-Time) ou un index pour garantir l'unicité des noms.

Mis à jour