# WriteImage

Verwenden Sie die Funktion „WriteImage“, um das aktuelle Bild auf einem lokalen Gerät oder einem FTP/SFTP-Server zu speichern. Optional können Sie eine SVG-Datei erstellen, die die Überlagerungsgrafiken auf dem Bild einschließt.

Hinweis:

- Sie können die Datei am ausgewählten Speicherort im Online- oder Offline-Modus speichern.
- Wenn Sie den Job so konfigurieren, dass eine große Anzahl von Bilddateien gespeichert wird, empfiehlt sich die Auswahl von FTP-Server oder SFTP-Server für die Einstellung „Speicher“. Wenn Sie eine große Anzahl von Bilddateien auf einem In-Sight-Gerät speichern (z. B. wenn der Parameter Ereignis auf , kann dies aufgrund von zu wenig verfügbarem Speicher zu massiven Problemen führen.

## WriteImage – Eingaben

Parameter | Beschreibung
Bild | Gibt eine Referenz auf eine Zelle mit einer Image-Datenstruktur an. Die Standardreferenz besteht zur Image-Datenstruktur in Zelle A0.
Ereignis | Gibt das Ereignis an, das eine Aktualisierung erzwingt. Dieser Parameter muss ein Verweis auf ein Ereignis mit einem Zeitstempel sein, z. B.: Eine Zelle, die eine Event-Funktion enthält. Eine Zelle, die eine Button-Funktion enthält. Hinweis: Standardmäßig ist der Ereignisreferenzwert 0. Wenn Sie den Standardwert nicht ändern, wird automatisch eine Schaltfläche mit der Beschriftung „Write“ erstellt und referenziert, wenn WriteImage in die Tabelle eingefügt wird.
Speicher | Gibt an, ob das Bild auf einem lokalen Gerät oder auf einem FTP-/SFTP-Server gespeichert werden soll. Der Speicherort hängt vom angeschlossenen Gerät und der Speichereinstellung der Funktion ab.
Speichereinstellung | Angeschlossenes Gerät | Speicherort
--- | --- | ---
Lokales Gerät | In-Sight-Gerät | In-Sight-Gerät Im In-Sight-Gerät installierte SD-Karte Hinweis: Zum Anzeigen von Dateien müssen Sie FTP-Software wie FileZilla Client verwenden. Weitere Informationen finden Sie unter Auf einem In-Sight-Gerät gespeicherte Dateien anzeigen. Wenn Sie einen SD-Kartenspeicher verwenden, müssen Sie vor dem Ausführen des Jobs die SD-Speicherkarte einstecken. Wenn Sie den SD-Kartenspeicher ohne eingesteckte SD-Karte konfigurieren, speichert der Job die Dateien im Verzeichnis /sdcard des internen Flash-Speichers.
PC | PC Hinweis: Das Speichern auf einem PC wird nur bei Verwendung eines FTP-Servers unterstützt.
FTP-Server | Beliebiges Gerät | Angegebener FTP-Server
SFTP-Server | Beliebiges Gerät | Angegebener SFTP-Server
Server | Gibt den Servernamen (oder die IP-Adresse) im Netzwerk an, auf den die Bilddatei geschrieben wird. Ein FTP-Server kann ein In-Sight-Emulator oder ein beliebiges Gerät sein, das im Netzwerk als FTP-Server erkannt wird. Hinweis: Diese Option ist nur aktiviert, wenn Sie als Speichertyp FTP-Server oder SFTP-Server wählen. Wenn ein bestimmter Port erforderlich ist, können Sie ihn an den Servernamen anhängen. Beispiel: Wenn der FTP/SFTP-Server Port 50021 verwendet, geben Sie „127.0.0.1:50021“ ein.
Benutzername | Gibt einen gültigen Benutzernamen für den FTP-/SFTP-Server an. Wenn dieses Feld leer gelassen wird, wird „admin“ verwendet. Hinweis: Diese Option ist nur aktiviert, wenn Sie als Speichertyp FTP-Server oder SFTP-Server wählen.
Kennwort | Legt das Kennwort für den FTP-/SFTP-Server fest. Beim Kennwort wird zwischen Groß- und Kleinschreibung unterschieden. Wenn für den FTP-/SFTP-Server kein Kennwort vorgesehen ist, können Sie dieses Feld leer lassen. Hinweis: Diese Option ist nur aktiviert, wenn Sie als Speichertyp FTP-Server oder SFTP-Server wählen. Aus Sicherheitsgründen wird das eingegebene Kennwort auf dem Eigenschaftsblatt und in der Formelleiste nur als „*“ dargestellt. Das Kennwort wird in verschlüsselter Form in der Jobdatei gespeichert.
Dateipfad | Gibt den Speicherort zum Speichern der Datei an. Beim Speichern auf dem PC kann die Datei in ein beliebiges Verzeichnis geschrieben werden, für das Sie Betriebssystem-Schreibrechte besitzen. Sie können in dieses Feld einen hartcodierten Pfad (z. B. X:/, X:/Unterverzeichnis), einen UNC-Pfad (z. B. Cognex/shared/), ein gemapptes Laufwerk (z. B. M:/Unterverzeichnis) oder einen relativen Pfad (../../Unterverzeichnis) eingeben. Wenn der Pfad auf dem In-Sight-Gerät oder dem PC nicht vorhanden ist, gibt die Funktion #ERR zurück. Wenn der Pfad oder die FTP-/SFTP-Anmeldeinformationen auf dem FTP-/SFTP-Server ungültig sind, gibt die Funktion keine #ERR-Fehlermeldung zurück. Beim Schreiben einer Datei auf einen FTP-Server können Sie außerdem einen Dateipfad angeben. Beim Schreiben einer Datei auf einen SFTP-Server können Sie auch einen absoluten Dateipfad angeben. Wenn Sie dem Pfad das Präfix ~ voranstellen, fügen Sie die Datei relativ zum Home-Verzeichnis des Benutzers des SFTP-Servers hinzu. Wenn Sie dieses Feld leer lassen, senden Sie die Datei an eines der folgenden Standardverzeichnisse: In-Sight-Gerät: Stammverzeichnis des Geräts. FTP-Server: Das Standardverzeichnis des angegebenen FTP-Servers. SFTP-Server: Das Stammverzeichnis des angegebenen SFTP-Servers.
Dateiname | Gibt den Namen der Bilddatei an und definiert außerdem den Namen der SVG-Datei. Hinweis: Folgen Sie den Beschränkungen des Betriebssystems hinsichtlich der zulässigen Zeichen. Sie können den angehängten Wertparameter des Dateinamens formatieren. Weitere Informationen finden Sie im Abschnitt „Formatieren des Parameters „Wert“ in diesem Thema.
Dateityp | Definiert das Dateiformat des Bilds.
0 = BMP (Standard) | Windows-Bitmap-Format (Dateierweiterung .BMP).
1 = JPEG | Codiertes JPEG-Standardformat (Dateierweiterung .JPG).
2 = PNG | Codiertes PNG-Standardformat (Dateierweiterung .PNG).
Maximaler Wert | Die maximale Anzahl (0 bis 9999999; Standard = 999) von eindeutigen Bilddateien, die unter dem angegebenen Dateinamen geschrieben werden können. Ein Zähler inkrementiert selbstständig, wenn die einzelnen Bilddateien geschrieben werden, und wird am Ende des angegebenen Dateinamens angehängt, wenn keine Formatspezifikationen verwendet werden. Andernfalls wird der Zähler gemäß der Formatspezifikationen an der entsprechenden Position hinzugefügt. Der Zähler wird automatisch zurückgesetzt, wenn er den Maximalwert erreicht hat. Vorhandene Bilddateien auf dem Zielsystem werden dann mit neuen Dateien mit demselben Namen überschrieben. Wenn der Wert auf -1 gesetzt ist oder außerhalb des Wertebereichs liegt, wird kein Zähler an den Dateinamen angehängt.
Zurücksetzen | Startet den Zähler, der an den angegebenen Dateinamen angehängt wird, neu bei 0. Nach dem Zurücksetzen werden bestehende Bilddateien auf dem Zielspeicherort durch neue Dateien mit demselben Namen überschrieben.
0 = AUS (Standard) | Der Zähler erhöht sich weiterhin mit jedem geschriebenen Bild bis zum maximalen Wert.
1 = EIN | Der Zähler wird auf 0 zurückgesetzt.
Hinweis: Standardmäßig ist das Kontrollkästchen „Zurücksetzen“ nicht aktiviert. Wenn Sie die Standardeinstellung nicht ändern, wird automatisch eine Schaltfläche mit der Beschriftung „Zurücksetzen“ erstellt und referenziert, wenn die WriteImage-Funktion erstmals in die Tabelle eingefügt wird.
Überlagerungsgrafiken | Legt fest, ob eine SVG-Datei mit den Überlagerungsgrafiken erstellt wird. Zum Anzeigen der SVG-Datei und der Bilddatei öffnen Sie die SVG-Datei in einem Webbrowser, der den Dateityp SVG unterstützt. Die SVG-Datei enthält eine interne Verknüpfung zu dem entsprechenden Bild. Wenn der Browser die SVG-Datei öffnet, wird mithilfe der Verknüpfung das aufgenommene Bild gemeinsam mit den Overlay-Grafiken angezeigt.
0 = AUS | Nur das Bild wird übertragen.
1 = EIN (Standard) | Es werden ein Bild und eine SVG-Datei übertragen. Wenn diese Option aktiviert ist, wird die SVG-Datei mit den Grafiküberlagerungsdaten in demselben Verzeichnis gespeichert, das für die Bilder angegeben wurde. Verwenden Sie einen Webbrowser, um die Überlagerungsgrafikdaten und Bilder zusammen anzuzeigen.
Hinweis: Falls aktiviert, verwendet die SVG-Datei den mit dem Parameter Dateiname festgelegten Dateinamen. Da die Grafiken von einer Drittanbieteranwendung wie einem Webbrowser gerendert werden, stimmen die Überlagerungsgrafikdaten nicht exakt Pixel für Pixel überein.

## WriteImage – Ausgaben

Rückgabewert | Eine WriteImage-Datenstruktur, die die in der angegebenen Image-Datenstruktur enthaltenen Bilddaten auf ein lokales Gerät oder einen FTP-/SFTP-Server schreibt, wenn das referenzierte Ereignis aktualisiert wird. Gibt #ERR zurück, wenn Eingabeparameter ungültig sind oder die Dateiwarteschlange voll ist. Gibt #ERR zurück, wenn der Speicher des Vision-Systems der In-Sight D900-Serie voll ist. Hinweis: Bei ungültigen FTP-/SFTP-Serverpfaden oder Dateinamen wird kein #ERR zurückgegeben. Tipp: Wenn Sie den Mauszeiger über #ERR bewegen, wird die folgende Fehlermeldung angezeigt:
Meldung | Fehlerursache
--- | ---
#ERR: Datei kann nicht geöffnet werden: Dateipfad/Dateiname | Der angegebene Parameter für „Dateipfad“ oder „Dateiname“ ist nicht korrekt (d. h. der Dateipfad wird nicht erstellt).
#ERR: Fehler 0:7:2: Dateipfad/Dateiname | Der Speicher des Vision-Systems ist voll.
Ergebnisse | Wenn WriteImage in die Tabelle eingefügt wird und sich die Parameter „Ereignis“ und/oder „Zurücksetzen“ in den Standardeinstellungen befinden, werden die Schaltflächen „Schreiben“ und/oder „Zurücksetzen“ automatisch in der Tabelle erstellt und referenziert.

## Formatieren des Parameters „Wert“

Sie können den Parameter „Wert“ über das Zeichen „|“ so formatieren, dass die Namen ausgerichtet sind. Wenn das Zeichen „|“ verwendet wird, wird der Wert entweder Null oder mit Leerzeichen gefüllt. Wenn das Zeichen unmittelbar nach dem Zeichen „|“ eine 0 ist, dann wird das Format mit Nullen gefüllt. Andernfalls wird es mit Leerzeichen gefüllt. Das/die nächste(n) Zeichen gibt/geben an, wieviel Nullen oder Leerzeichen eingefügt werden sollen. Wenn der Dateiname mehrere „|“-Zeichen enthält, werden die letzten als Formatanzeiger verwendet. Wenn das „|“-Zeichen nicht von einer Zahl gefolgt wird, wird das „|“-Zeichen gemäß den Beschränkungen des Betriebssystems als Teil des Namens verwendet.

Wenn der Dateiname auf MyImage eingestellt ist, sehen die gespeicherten Dateinamen wie folgt aus:

Wenn der Dateiname auf MyImage|03 eingestellt ist, sehen die gespeicherten Dateinamen wie folgt aus:

Wenn der Dateiname auf MyImage|3 eingestellt ist, sehen die gespeicherten Dateinamen wie folgt aus:

Wenn sich das „|“-Zeichen in der Mitte des Dateinamens befindet, wird der angehängte Wert dort eingefügt. Wenn beispielsweise der Dateiname auf Fail_Image|03JobX eingestellt ist, sehen die gespeicherten Dateinamen wie folgt aus: