Benutzerdefinierte Sequenzen erstellen

Um eine benutzerdefinierte Sequenz für Ihre Bildquellen-Konfiguration zu erstellen, müssen Sie eine Aufnahmesequenz-Datei erstellen, die die gewünschten Aufnahmeeinstellungen enthält. Die Sequenzdatei muss als JSON-Konfigurationsdatei mit einer bestimmten Dateiendung (.seq) erstellt werden. Sie können für eine Bildquellen-Konfiguration beliebig viele benutzerdefinierte Sequenzen erstellen. Wenn Sie die Konfiguration einer bestehenden benutzerdefinierten Sequenz ändern möchten, müssen Sie Ihre Anpassungen in der entsprechenden Sequenzdatei vornehmen.

Anforderungen

Aufnahmesequenzen sind Teil einer Bildquellen-Konfiguration. Daher müssen Sie zunächst eine Bildquellen-Konfiguration erstellen, die eine oder mehrere Bildquellen enthält. Stellen Sie sicher, dass Sie alle Bildquellen hinzufügen, die Sie über Aufnahmesequenzen konfigurieren möchten. Bei Bedarf können Sie auch alternative Parametersätze für die Bildquellen definieren, die geladen werden sollen, wenn Ihre benutzerdefinierte Sequenz aktiviert wird.

Weitere Informationen finden Sie unter Neue Konfigurationen und Bildquellen hinzufügen und Parameter von Kameras oder Peripheriegeräten speichern.

Eine benutzerdefinierte Sequenz erstellen

Im Folgenden wird beschrieben, wie Sie eine benutzerdefinierte Aufnahmesequenz auf der Grundlage einer Vorlage für eine Aufnahmedatei erstellen können. Die Vorlage kann als Ausgangspunkt für die Konfiguration verwendet werden.

1. Öffnen Sie eine neue Datei in einem beliebigen Editor und kopieren Sie den Inhalt der folgenden Vorlage in Ihre Datei.
   Vorlage

   Kopieren

   {
     "$schema": "http://download.mvtec.com/acquisition-sequence-v2.0.schema.json",
     "Version": "2.0",
     "Lanes": [
       {
         "DeviceType": "ImageSource",
         "DeviceId": "Cam1",
         "AlternativeParameterSet": "param_set_1",
         "Actions": [
           {
             "Type": "SetParameter",
             "Attributes": {
               "ParameterName": "[Consumer]exposure",
               "ParameterValue": 200.0
             }
           },
           {
             "Type": "AcquireImage",
             "Attributes": {
               "ImageName": "Image1"
             }
           },
           {
             "Type": "Delay",
             "Attributes": {
               "Milliseconds": 2000
             }
           },
           {
             "Type": "Barrier",
             "Attributes": {
               "BarrierName": "barrier1"
             }
           }
         ]
       },
       {
         "DeviceType": "ImageSource",
         "DeviceId": "Cam2",
         "AlternativeParameterSet": "param_set_2",
         "Actions": [
           {
             "Type": "Barrier",
             "Attributes": {
               "BarrierName": "barrier1"
             }
           },
           {
             "Type": "AcquireImage",
             "Attributes": {
               "ImageName": "Image2"
             }
           }
         ]
       }
     ]
   }

2. Speichern Sie die Datei mit der Endung „.seq“. Stellen Sie sicher, dass Sie die Datei in dem Verzeichnis der Bildquellen-Konfiguration speichern, für die die Aufnahmesequenz definiert wird. Der Name der Sequenzdatei definiert den Namen der Aufnahmesequenz.

   Für jede Bildquellen-Konfiguration erstellt MERLIC ein Konfigurationsverzeichnis, in dem sich die jeweiligen Konfigurationsdateien der Bildquellen befinden. Es enthält eine JSON-Datei für jede Bildquelle und PERS-Dateien für die persistenten Kameraparameter. Standardmäßig werden diese ISM-Konfigurationsverzeichnisse im folgenden Verzeichnis erstellt: „%APPDATA%\MVTec\Configurations“. Der Name eines Konfigurationsverzeichnisses entspricht dem Namen der Bildquellen-Konfiguration.

   Im folgenden Beispielbild wurde die Sequenzdatei für die ISM-Konfiguration mit dem Namen „MyConfiguration“ hinzugefügt. Der zugehörige Pfad lautet daher „%APPDATA%\MVTec\Configurations\MyConfiguration“.

   

3. Passen Sie die Konfiguration in der Sequenzdatei an Ihre Bildquellen-Konfiguration und Ihren Anwendungsfall an:
   1. Passen Sie bei Bedarf die Anzahl der „Spuren“ (lanes) an. Die Vorlage enthält eine Beispielkonfiguration mit zwei lanes, da sie die Konfiguration für zwei Kamerageräte enthält. Wenn Sie mehr als zwei Bildquellen konfigurieren möchten, fügen Sie für jede zu konfigurierende Bildquelle eine neue Spur hinzu.
   2. Passen Sie für jede Spur den Wert des Attributs „DeviceId“ an den Namen der Bildquelle an, für die die jeweilige Spur konfiguriert werden soll.
   3. Stellen Sie sicher, dass das Attribut „DeviceType“ für jede Spur auf „ImageSource“ gesetzt ist. Dies gilt auch für Spuren, die Nicht-Streaming-Geräte konfigurieren, die im GenICam-Producer zur Verfügung stehen, z. B. Geräte, die nur für die Beleuchtung verwendet werden.
   4. Passen Sie für jede Spur den Wert des Attributs „AlternativeParameterSet“ an:
      • Wenn der primäre Parametersatz verwendet werden soll, setzen Sie das Attribut auf null.
      • Soll ein alternativer Parametersatz verwendet werden, definieren Sie den Namen des gewünschten Parametersatzes.
   5. Passen Sie die Konfiguration des Abschnitts „Actions“ für jede Spur an. Hier wird eine Reihe von „Aktionen“ definiert, die auf die jeweilige Bildquelle angewendet werden, beispielsweise einen Bildeinzug. Folgende Aktionstypen stehen zur Verfügung:
      • AcquireImage
      • SetParameter
      • Delay
      • Barrier

      Weitere Informationen zur Struktur und zu den Aktionen für Aufnahmesequenzen finden Sie unter Struktur von Sequenzdateien. Weitere Informationen zu bestimmten Beispielsequenzen finden Sie unter Samples von Aufnahmesequenzen.

   6. Speichern Sie die Änderungen. Bitte überprüfen Sie die gültige Formatierung der Datei im JSON-Format, um Fehler beim Laden der Konfiguration für eine MVApp zu vermeiden.
4. Laden Sie die ISM-Konfigurationen einschließlich der Sequenzdateien neu, damit Ihre Änderungen übernommen werden. Es gibt verschiedene Möglichkeiten, einen Neuladevorgang auszulösen:
   • Starten Sie das MERLIC RTE Setup neu.
   • Drücken Sie in der Registerkarte „Bildquellen“ des MERLIC RTE Setups die Alt-Taste, um die Schaltfläche „Aktualisieren“ in „Neu laden“ umzuwandeln, und klicken Sie auf „Neu laden“.

     Durch das Neuladen der ISM-Konfiguration werden alle Kameras erneut geöffnet und die Standard-Aufnahmesequenzen aktiviert, unabhängig davon, welche Aufnahmesequenz zuvor aktiv war.

5. Ihre benutzerdefinierte Aufnahmesequenz wird nun in der Übersicht für die jeweilige Bildquellen-Konfiguration angezeigt. Wählen Sie bei Bedarf eine Standardsequenz für Ihre Bildquellen-Konfiguration aus, wie unter Aufnahmesequenzen anzeigen und aktivieren beschrieben.

   

   Wenn die Sequenzdatei nicht geladen werden konnte, beispielsweise aufgrund von Kompatibilitätsproblemen oder Syntaxfehlern, wird sie im MERLIC RTE Setup mit einem Fehlersymbol gekennzeichnet. Darüber hinaus werden die Fehlerdetails in der Log-Datei für MERLIC Creator protokolliert, die standardmäßig im Verzeichnis „%LOCALAPPDATA%\MVTec\MERLIC\“ erstellt wird. Die betreffende Sequenz kann erst verwendet werden, nachdem die Konfiguration in der Sequenzdatei korrigiert wurde und die ISM-Konfigurationen neu geladen wurden. Erst dann kann sie als Standardsequenz festgelegt und aktiviert werden. Weitere Informationen finden Sie unter Fehlerbehebung bei benutzerdefinierten Aufnahmesequenzen.