# WriteImage

Utilisez la fonction WriteImage pour enregistrer l’image actuelle sur un périphérique local ou un serveur FTP/SFTP. En option, vous pouvez créer un fichier SVG contenant les graphiques superposés, ou calques, de l’image.

Remarque :

- Vous pouvez enregistrer le fichier à l’emplacement de stockage sélectionné, en état En ligne ou Hors ligne.
- Si vous configurez le projet afin de pouvoir enregistrer un grand nombre de fichiers image, il est recommandé de sélectionner Serveur FTP ou Serveur SFTP comme Stockage. Si vous enregistrez un grand nombre de fichiers image sur un périphérique In-Sight (par exemple, si le paramètre Événement est réglé sur , le manque de stockage disponible peut grandement perturber le bon fonctionnement du système.

## WriteImage – entrées

Paramètre | Description
Image | Indique une référence à une cellule contenant une structure de données Image. La structure de données Image par défaut se trouve dans la cellule A0.
Événement | Indique l’événement forçant une mise à jour. Ce paramètre doit être une référence à un événement avec horodatage, par exemple l’un des événements suivants : Une cellule contenant une fonction Event. Une cellule contenant une fonction Button. Remarque : Par défaut, la valeur de référence de l’événement est 0. Si vous ne modifiez pas la valeur par défaut, un bouton étiqueté « Write » est automatiquement créé et référencé à la première insertion de WriteImage dans la feuille de calcul.
Stockage | Permet de préciser que la fonction WriteImage doit enregistrer l’image actuelle sur un périphérique local ou sur un serveur FTP/SFTP. L’emplacement d’enregistrement dépend du périphérique connecté et du paramètre Stockage de la fonction.
Paramètre Stockage | Périphérique connecté | Emplacement d’enregistrement
--- | --- | ---
Périphérique local | Périphérique In-Sight | Périphérique In-Sight Carte SD insérée dans le périphérique In-Sight Remarque : Vous devez utiliser un logiciel FTP, le client FileZilla par exemple, pour afficher les fichiers. Pour plus d’informations, consultez la rubrique Afficher les fichiers stockés sur un périphérique In-Sight. Si vous stockez des fichiers sur une carte SD, assurez-vous d’insérer la carte SD avant d’exécuter le projet. Si l’emplacement de stockage configuré est sur la carte SD et cette dernière n’est pas insérée, le projet enregistrera les fichiers dans le répertoire /sdcard de la mémoire flash interne.
PC | PC Remarque : L’enregistrement sur un PC est uniquement possible avec un serveur FTP.
Serveur FTP | Tout périphérique | Serveur FTP spécifié
Serveur SFTP | Tout périphérique | Serveur SFTP spécifié
Serveur | Spécifie le nom (ou l’adresse IP) du serveur réseau sur lequel enregistrer l’image. Un serveur FTP peut être un émulateur In-Sight ou tout autre périphérique reconnu comme serveur FTP sur le réseau. Remarque : Cette option est uniquement activée lorsque vous sélectionnez Serveur FTP ou Serveur SFTP comme Type de stockage. Lorsqu’un port particulier est requis, vous pouvez l’ajouter au nom du serveur. Par exemple, si le serveur FTP/SFTP utilise le port 50021, entrez "127.0.0.1:50021".
Nom d’utilisateur | Définit un nom d’utilisateur valide pour le serveur FTP/SFTP. Lorsque ce champ est laissé vide, « admin » est utilisé. Remarque : Cette option est uniquement activée lorsque vous sélectionnez Serveur FTP ou Serveur SFTP comme Type de stockage.
Mot de passe | Indique le mot de passe du serveur FTP/SFTP. Le mot de passe est sensible à la casse. Si le serveur FTP/SFTP ne possède pas de mot de passe, vous pouvez laisser ce champ vide. Remarque : Cette option est uniquement activée lorsque vous sélectionnez Serveur FTP ou Serveur SFTP comme Type de stockage. Pour des raisons de sécurité, le mot de passe entré sera remplacé par des "*" dans la feuille de propriétés et dans la barre de formule. Le mot de passe est enregistré dans le fichier de projet sous forme cryptée.
Chemin d’accès du fichier | Indique l’emplacement où vous souhaitez enregistrer le fichier. Vous pouvez écrire le fichier à l’emplacement de votre choix, à l’exception des emplacements pour lesquels vous n’avez pas l’autorisation nécessaire. Dans ce champ, vous pouvez entrer un chemin codé en dur (par ex : X:/, X:/Sous-rép), un chemin UNC (par ex : //Cognex/shared/), un lecteur mappé (par exemple, M:/Sous-rép) ou un chemin relatif (../../ Sous-rép). Si le chemin n’existe pas sur le périphérique In-Sight ou sur le PC, la fonction renvoie #ERR. Si le chemin ou les informations d’identification FTP/SFTP sont non valides sur le serveur FTP/SFTP, la fonction ne renvoie pas #ERR. Lorsque vous enregistrez un fichier sur un serveur FTP, vous pouvez également spécifier un chemin d’accès. Lorsque vous enregistrez un fichier sur un serveur SFTP, vous pouvez également spécifier un chemin d’accès absolu. Si vous préfixez le chemin avec ~, vous ajoutez le fichier relativement au répertoire de base de l’utilisateur du serveur SFTP. Si vous laissez ce champ vide, vous envoyez le fichier vers l’un des emplacements par défaut suivants : Périphérique In-Sight : répertoire racine du périphérique. Serveur FTP : le répertoire par défaut du serveur FTP spécifié. Serveur SFTP : le répertoire racine du serveur SFTP spécifié.
Nom du fichier | Spécifie le nom du fichier image ; spécifie également le nom du fichier SVG. Remarque : Respectez les restrictions du système d’exploitation quant aux caractères autorisés. Vous pouvez formater le paramètre d’ajout de valeur au nom de fichier. Pour plus d’informations, consultez la section Format du paramètre de valeur dans cette rubrique.
Type de fichier | Détermine le format de fichier de l’image.
0 = BMP (par défaut) | Format Windows bitmap (extension .BMP).
1 = JPEG | Format JPEG standard crypté (extension .JPG).
2 = PNG | Format PNG encodé standard (extension .PNG)
Valeur max. ajoutée | Indique le nombre maximum (0 à 9999999 ; 999 par défaut) de fichiers image uniques pouvant être écrits en utilisant le Nom de fichier spécifié. Un compteur est incrémenté à chaque écriture de fichier image et est ajouté à la fin du nom de fichier spécifié si aucun spécificateur de format n’est précisé. Dans le cas contraire, le compteur est ajouté à l’emplacement du spécificateur de format. Il se remet automatiquement à zéro lorsqu’il atteint la Valeur max et les fichiers image présents sur le système cible sont écrasés par les nouveaux fichiers portant le même nom. Si la valeur est définie sur -1 ou en dehors de la plage de valeurs, aucun compteur n’est ajouté au nom du fichier.
Réinitialisation | Réinitialise à 0 le compteur qui est ajouté au nom de fichier. Après la réinitialisation, les fichiers images existants à l’emplacement cible sont écrasés par les nouveaux fichiers du même nom.
0 = OFF (par défaut) | Le compteur continue de s’incrémenter lors de l’écriture de chaque image, et ce jusqu’à la Valeur max.
1 = ON | Le compteur se remet à 0.
Remarque : Par défaut, la case Réinitialisation n’est pas cochée. Si vous ne modifiez pas le réglage par défaut, un bouton étiqueté « Reset » est automatiquement créé et référencé à la première insertion de la fonction WriteImage dans la feuille de calcul.
Graphiques superposés | Indique si un fichier SVG avec des graphiques superposés est créé. Pour afficher le fichier SVG et un fichier d’image, ouvrez-le à l’aide d’un navigateur Web qui prend en charge le type de fichier SVG. Le fichier SVG contient un lien interne vers l’image acquise qui lui est associée, et lorsque le navigateur ouvre le fichier SVG, il suit le lien pour ouvrir et afficher l’image acquise avec des graphiques superposés.
0 = OFF | Seule l’image est transférée.
1 = ON (par défaut) | L’image et un fichier SVG seront transférés. Lorsque cette fonction est activée, le fichier SVG contenant les données des graphiques superposés est enregistré dans le même répertoire que celui indiqué pour les images. Utilisez un navigateur Web pour afficher les données et les images des graphiques superposés.
Remarque : Lorsqu’elle est cochée, le fichier SVG utilise le nom spécifié dans le paramètre Nom du fichier. Comme les graphiques sont rendus par une application tierce, telle qu’un navigateur Web, les données des graphiques superposés ne correspondent pas au pixel près.

## WriteImage – Sorties

Renvoie | Une structure de données WriteImage qui écrit les données d’image contenues dans la structure de données Image spécifiée sur un périphérique local ou un serveur FTP/SFTP, à chaque fois que l’événement référencé est mis à jour. Renvoie #ERR si un paramètre d’entrée est non valide ou si la file d’attente de fichiers est pleine. Renvoie #ERR si la mémoire du système de vision In-Sight série D900 est pleine. Remarque : Un chemin ou nom de fichier de serveur FTP/SFTP non valide ne renvoie pas #ERR. Astuce : En survolant la fonction #ERR, le message d’erreur suivant s’affiche :
Message | Motif de l’erreur
--- | ---
#ERR : Impossible d’ouvrir le fichier : chemin/nom du fichier | Le paramètre de chemin d’accès ou de nom de fichier spécifié est incorrect (le chemin d’accès du fichier n’est pas créé).
#ERR : Erreur 0:7:2 : chemin/nom du fichier | La mémoire du système de vision est pleine.
Résultats | Lorsque la fonction WriteImage est insérée dans la feuille de calcul pour la première fois, et si les paramètres Événement et/ou Réinitialisation sont définis par défaut, les boutons Write et/ou Reset sont automatiquement créés et référencés dans la feuille de calcul.

## Format du paramètre de valeur

Avec le caractère '|', vous pouvez définir le format du paramètre de valeur de manière à ce que les noms soient harmonisés. Si '|' est utilisé, la valeur est soit zéro, soit vide. Si le caractère immédiatement après '|' est 0, le format est rempli de zéros ; dans le cas contraire, il est rempli de vides. Les caractères suivants indiquent comment les 0 ou les ’ ’ s’insèrent. Si le nom du fichier contient plusieurs caractères '|', le dernier est utilisé comme indicateur de format. Si '|' n’est pas suivi d’un chiffre, alors '|' sera utilisé dans le nom, conformément aux restrictions du système d’exploitation.

Si le Nom du fichier est défini sur MyImage, les noms des fichiers enregistrés sont :

Si le Nom du fichier est défini sur MyImage|03, les noms des fichiers enregistrés sont :

Si le Nom du fichier est défini sur MyImage|3, les noms des fichiers enregistrés sont :

Si '|' est au milieu du nom du fichier, la valeur ajoutée sera insérée en ligne. Par exemple, si le Nom du fichier est défini sur Fail_Image|03JobX, les noms des fichiers enregistrés sont :