Region lesen

Mit diesem Tool können Sie eine Region aus einer Datei lesen, die zuvor mit dem Tool Region schreiben gespeichert wurde. Das Tool liest die Regionen sofort aus der Datei, wenn der „Dateiname“ geändert wird.

Parameter

Standardparameter

Dateiname:

Dieser Parameter definiert den Namen und den Pfad der Datei, aus der die Region gelesen wird. Die Standardeinstellung ist „Me_region.hobj“ im Verzeichnis „%USERPROFILE%\Documents“. Sie können den gewünschten Dateinamen und Pfad über die zugehörige Verbindungsstelle ändern oder auswählen. Sie können Regionen aus den Dateitypen „.reg“ oder .hobj Bei HOBJ handelt es sich um ein binäres Dateiformat, das die Möglichkeit bietet, alle möglichen ikonischen HALCON-Objekte (Bilder, Regionen und XLDs) 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. lesen. Wenn Sie einen relativen Dateipfad definieren, erfolgt die Dateisuche relativ zum Standardverzeichnis „%USERPROFILE%\Documents“. 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.

Ergebnisse

Standardergebnisse

Region:

Dieses Ergebnis enthält die Region, die aus der ausgewählten Datei gelesen wurde. Die Region wird auch im Toolboard hervorgehoben.

Aktueller Dateiname:

Dieses Ergebnis enthält den Namen und absoluten Dateipfad der Datei, die in der letzten Iteration gelesen wurde, z. B. „C:\Users\Public\Documents\MVTec\MERLIC\Me_region.hobj“.

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.