Region schreiben

Mit diesem Tool können Sie eine Region in eine Datei schreiben. Die Region wird standardmäßig im Dateiformat .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. geschrieben. Der Schreibvorgang wird bei jeder Ausführung der MVApp durchgeführt. Sie können die Regionen in der Datei mit dem Tool Region lesen in jede MERLIC-Vision-App laden.

Für dieses Tool muss die Region verfügbar sein und von einem vorherigen Tool übergeben werden.

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 „Region 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:

Mit diesem Parameter können Sie ein Bild als Hintergrund festlegen. Dies sollte normalerweise das Bild sein, auf dem die verarbeiteten Merkmale wie Konturen oder ROIs basieren. Ist kein Bild verbunden, ist der Hintergrund schwarz.

Region:

Dieser Parameter enthält die Region, die in die ausgewählte Datei geschrieben wird. Der Rand der Region wird zur Verdeutlichung hervorgehoben. Die Region muss von einem vorherigen Tool übertragen werden. Daher müssen Sie den Parameter mit einem Ergebnis eines vorherigen Tools verbinden. Die verbundene Region wird dann in die Datei geschrieben.

Dateiname:

Dieser Parameter definiert den Namen und den Pfad der Datei, in die die Region geschrieben 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. Regionen werden standardmäßig im „.hobj“-Dateiformat gespeichert. Sie können die Regionen aber auch in eine Datei mit dem Format „.reg“ schreiben. Wenn Sie einen relativen Dateipfad definieren, erfolgt die Suche der angegebenen Datei 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.

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.

Ergebnisse

Standardergebnisse

Aktueller Dateiname:

Dieses Ergebnis enthält den Namen und absoluten Dateipfad der Datei, die in der letzten Iteration gespeichert 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.