Bild-Datei schreiben

Mit diesem Tool können Sie eine Bild-Datei schreiben. Geben Sie das Ziel zum Speichern des Bilds im Parameter „Dateiname“ an. Der Schreibvorgang wird bei jeder Ausführung der MVApp durchgeführt.

Ausführungsverhalten

Das Ausführungsverhalten dieses Tools weicht vom Standardverhalten ab. Normalerweise wird ein MERLIC-Tool in den folgenden Fällen ausgeführt:

  • Die MERLIC-Vision-App wird explizit im kontinuierlichen Modus ausgeführt.
  • Die MERLIC-Vision-App wird explizit im Modus „Einmal ausführen“ ausgeführt.
  • Eine MERLIC-Vision-App mit dem Tool wird im MERLIC Creator geöffnet.
  • Ein Parameterwert des Tools wurde im MERLIC Creator geändert.

Das Tool „Bild-Datei schreiben“ wird jedoch nur in den folgenden Fällen ausgeführt:

  • Die MERLIC-Vision-App wird explizit im kontinuierlichen Modus ausgeführt.
  • Die MERLIC-Vision-App wird explizit im Modus „Einmal ausführen“ ausgeführt.

Dadurch wird sichergestellt, dass beim Laden einer MVApp oder beim Ändern eines Parameterwerts des Tools keine Schreibvorgänge durchgeführt werden.

Parameter

Standardparameter

Bild:

Dieser Parameter stellt das Bild dar, das in die ausgewählte Datei geschrieben wird.

Bei der Verwendung eines Farbbilds als Eingabebild werden alle Kanäle des Farbbilds für die Verarbeitung verwendet.

Dateiname:

Dieser Parameter definiert den Namen und den Pfad der Datei, in die das Bild geschrieben wird. Die Standardeinstellung ist „Me_Image.png“ im Verzeichnis „%USERPROFILE%\Desktop“. Sie können den Dateinamen und damit auch den Speicherort des zu schreibenden Bildes über den zugehörigen Parameter ändern. Wenn Sie einen relativen Dateipfad definieren, erfolgt die Dateisuche relativ zum Standardverzeichnis „%USERPROFILE%\Desktop“. Wurde die MVApp jedoch bereits gespeichert, wenn Sie einen relativen Dateipfad definieren, erfolgt die Dateisuche relativ zu dem Verzeichnis, in dem sich die MVApp befindet.

Dateiformat:

Dieser Parameter definiert das Format, in dem die Bild-Datei geschrieben wird. Die Standardeinstellung ist „png none“. Sie können das Format über die zugehörige Verbindungsstelle ändern.

Wert

Beschreibung

png none

Das Bild wird unkomprimiert im Format png geschrieben. Diese Option ist schneller als png.

png fastest

Das Bild wird mit der schnellsten Komprimierung im Format png geschrieben.

png best

Das Bild wird mit dem höchsten Komprimierungsgrad im Format png geschrieben.

png

Das Bild wird im Format png geschrieben. Diese Option ist langsamer als png none.

HOBJ

Das Bild wird im Format HOBJ geschrieben. Bei HOBJ handelt es sich um ein binäres Dateiformat, das die Möglichkeit bietet, alle möglichen ikonischen HALCON Bei MVTec HALCON handelt es sich um die umfassende Standardsoftware für die Bildverarbeitung mit einer integrierten Entwicklungsumgebung (HDevelop). MERLIC verwendet verschiedene HALCON-Prozeduren und andere Programmfunktionen.-Objekte (Bilder, Regionen usw.) zu schreiben und zu lesen. Da die Daten ohne Komprimierung und ohne Konvertierung geschrieben werden, sind Schreibvorgänge in diesem Dateiformat in den meisten Fällen schneller als bei anderen Dateiformaten. Daher sollte dieses Format verwendet werden, wenn eine Anwendung alle möglichen ikonischen HALCON-Objekte so schnell wie möglich lesen und schreiben muss und keine Komprimierung erforderlich ist. Für Bilder können alle HALCON-Pixeltypen geschrieben werden. Mehrkanalbilder werden unterstützt. Die Kanäle können über unterschiedliche Pixeltypen verfügen, müssen aber die gleiche Breite und Höhe aufweisen. Der Bildbereich und das Bilderstellungsdatum werden ebenfalls in der Datei gespeichert. Ein Objekttupel wird in eine einzelne Datei geschrieben.

tiff

Das Bild wird im Format tiff geschrieben.

bmp

Das Bild wird im Format bmp geschrieben.

jpeg

Das Bild wird im Format jpeg geschrieben.

jpeg 100

Das Bild wird im Format jpeg 100 geschrieben.

jpeg 80

Das Bild wird im Format jpeg 80 geschrieben.

jpeg 60

Das Bild wird im Format jpeg 60 geschrieben.

jpeg 40

Das Bild wird im Format jpeg 40 geschrieben.

jpeg 20

Das Bild wird im Format jpeg 20 geschrieben.

ima

Das Bild wird im Format ima geschrieben.
Verzeichnisse erstellen:

Dieser Parameter definiert, ob MERLIC das im Parameter „Dateiname“ angegebene Verzeichnis erstellt, falls es noch nicht vorhanden ist. Der Parameter ist standardmäßig auf 0 festgelegt, d. h., es wird kein Verzeichnis erstellt. Ist der Parameter auf 1 festgelegt und das in „Dateiname“ angegebene Verzeichnis nicht vorhanden, erstellt MERLIC das fehlende Verzeichnis, wenn die MVApp ausgeführt wird.

Zusätzliche Parameter

Dateipräfix:

Dieser Parameter definiert die Zeichenfolge, die beim Speichern des Bildes als Präfix zum Dateinamen hinzugefügt wird. Die Standardeinstellung ist „keine“. Sie können einen der Werte, die in der Werteliste des Parameters verfügbar sind, auswählen oder eine Zeichenfolge in das Textfeld des Parameters eingeben. So können Sie ein benutzerdefiniertes Präfix für den Dateinamen definieren. Sie können auch das Ergebnis eines vorherigen Tools mit dieser Verbindungsstelle verbinden, wenn Sie Informationen der jeweiligen Iteration für das Präfix verwenden möchten.

In der Werteliste sind die folgenden Werte verfügbar:

Wert

Beschreibung

keine

Zum Dateinamen des Bildes wird kein Präfix hinzugefügt.

Datum und Uhrzeit

Bei Auswahl dieses Werts wird ein Präfix mit dem aktuellen Datum und der aktuellen Uhrzeit zum Dateinamen hinzugefügt. Das Format für das Präfix ist:

YYYY_MM_DDThh-mm-ss_lll

Beispiel: 2022_08_25T11-15-46_225_Me_Image.png
Dateisuffix:

Dieser Parameter definiert die Zeichenfolge, die beim Speichern des Bildes als Suffix zum Dateinamen hinzugefügt wird. Die Standardeinstellung ist „keine“. Sie können einen der Werte, die in der Werteliste des Parameters verfügbar sind, auswählen oder eine Zeichenfolge in das Textfeld des Parameters eingeben. So können Sie ein benutzerdefiniertes Suffix für den Dateinamen definieren. Sie können auch das Ergebnis eines vorherigen Tools mit dieser Verbindungsstelle verbinden, wenn Sie Informationen der jeweiligen Iteration für das Suffix verwenden möchten.

In der Werteliste sind die folgenden Werte verfügbar:

Wert

Beschreibung

keine

Zum Dateinamen des Bildes wird kein Suffix hinzugefügt.

Datum und Uhrzeit

Bei Auswahl dieses Werts wird ein Suffix mit dem aktuellen Datum und der aktuellen Uhrzeit zum Dateinamen hinzugefügt. Das Format für das Suffix ist:

YYYY_MM_DDThh-mm-ss_lll

Beispiel: Me_Image_2022_08_25T11-15-46_225.png

Ergebnisse

Standardergebnisse

Aktueller Dateiname:

Dieses Ergebnis enthält den Namen und absoluten Dateipfad des Bildes, das in der letzten Iteration gespeichert wurde, z. B. „C:\Users\Public\Documents\MVTec\MERLIC\write_to_file_images\2022_08_25T11-15-46_225_Me_Image.png“.

Toolstatus:

„Toolstatus“ gibt Informationen zum Status des Tools aus und kann daher für die Fehlerbehandlung verwendet werden. Weitere Informationen zu den verschiedenen Toolstatus-Ergebnissen finden Sie unter Toolstatus-Ergebnis.

Zusätzliche Ergebnisse

Verarbeitungszeit:

Dieses Ergebnis gibt die Dauer der letzten Ausführung des Tools in Millisekunden aus. Das Ergebnis wird als zusätzliches Ergebnis bereitgestellt. Es ist daher standardmäßig ausgeblendet, kann aber über die Schaltfläche neben den Toolergebnissen angezeigt werden. Weitere Informationen finden Sie im Abschnitt Verarbeitungszeit in der Tool-Referenz-Übersicht.