Codes auf einem Bild-Stream lesen (experimentell)

Der Bild-Stream ist experimentell. Seine Knoten und Einstellungen können sich noch ändern. Verwenden Sie ihn zur Evaluierung, und prüfen Sie ihn mit Ihren Kameras und Ihrem Data Layer, bevor Sie sich darauf verlassen.

execute liest ein Bild pro Aufruf: Ihr Programm setzt input/image-address und schreibt auf execute. Ein Bild-Stream funktioniert umgekehrt. Der Cam Driver veröffentlicht jedes Bild, das er aufnimmt, auf <camera name>/control/publish/output/stream/frame, mit seiner Größe, seinem Pixelformat und seiner Lineage (siehe das Handbuch des Cam Driver, Bilder streamen). Der Reader abonniert den Stream einer Kamera, liest jeden Barcode in jedem Frame, sobald er eintrifft, und veröffentlicht ein Ergebnis pro Frame auf control/subscribe/output/stream/result.

Jeder Frame wird genau so gelesen, wie execute ein Bild liest. execute hat keine andere Eingabe als die Bildadresse, und an deren Stelle tritt der Frame. input/parameter wird von keinem der beiden gelesen: siehe Data-Layer-Referenz.

Jedes Ergebnis trägt die Lineage seines Frames - welche Kamera ihn aufgenommen hat, in welchem Lauf des Kamera-Streams, als welchen Frame des Laufs - ergänzt um den eigenen Schritt des Readers. Siehe Die Lineage eines Ergebnisses.

Standardmäßig fällt der Reader nie hinter seine Kamera zurück. Treffen Frames schneller ein, als der Reader sie liest, nimmt er jedes Mal, wenn das vorherige Lesen abgeschlossen ist, den neuesten Frame. Die Frames dazwischen werden als übersprungen gezählt. Wie viele Frames warten dürfen, legt die Warteschlangengröße fest, siehe Die Warteschlangengröße.

Das allgemeine Konzept der Streams, das die anderen LumiScan-Anwendungen teilen, ist in Streams beschrieben. Diese Seite beschreibt den Stream des Readers.

Die Knoten des Streams

Der Reader hat die Knoten des Streams unabhängig davon, ob er einen Stream abonniert oder nicht. Um sie zu verwenden, ist kein Neustart nötig. Alle Adressen unten beginnen mit hdvisionsystems/lumiscan-barcode-reader/. Es gibt keine Module: ein Stream pro Installation.

Tabelle 1. Methoden
Adresse Bedeutung

control/subscribe/execute

Prüft die fünf Eingaben von control/subscribe gemeinsam, speichert sie in der Einstellungsdatei des Readers und wendet sie dann an: Ein laufender Stream folgt bei seinem nächsten Zyklus, ohne Neustart. Eine Eingabe allein zu schreiben ändert nichts. Siehe Die Quelle ändern.

control/unsubscribe/execute

Entfernt die in control/unsubscribe/input/address genannte Quelle, womit auch der Stream-Modus endet. Das Tag bleibt. Wird wie ein Subscribe in der Einstellungsdatei des Readers gespeichert.
Tabelle 2. Eingaben von control/subscribe
Adresse Typ Bedeutung

control/subscribe/input/enable

bool

Stream-Modus: true lässt den Stream laufen, false stoppt ihn.

control/subscribe/input/address

string

Die eine Quelle: der Stream-Ordner einer Kamera, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream. Der Reader liest dessen Knoten frame. Eine andere Adresse ersetzt die Quelle.

control/subscribe/input/tag

string

Das Tag, das der Reader auf seine Ergebnisse setzt: Der Schritt des Readers in der Lineage jedes Ergebnisses trägt es, sodass jeder, der ein Ergebnis weiter unten in der Kette liest, sieht, welches Modul es gelesen hat. Leer: der Name des Readers, lumiscan-barcode-reader. Ein neues Tag markiert das nächste Ergebnis; die Quelle bleibt abonniert.

control/subscribe/input/queue-size

uint32

Wie viele Frames warten dürfen, während ein Frame gelesen wird: 1 bis 64. Siehe Die Warteschlangengröße.

control/subscribe/input/keep-latest-output

bool

true, um jedes Stream-Ergebnis zusätzlich in output/results zu schreiben. Siehe Das neueste Ergebnis behalten.

Die Eingaben sind beim Start der Anwendung mit dem vorbelegt, was angewendet ist; ein Client kann also eine von ihnen ändern und execute aufrufen.

Was die Quelle enthalten muss: Lesen Sie system/meta/subscription-schema. Es ist ein JSON Schema des Knotens frame der Quelle, eines stream_image mit seiner lineage und seinem image, in seiner JSON-Form. Siehe Data-Layer-Referenz.

Tabelle 3. Eingabe von control/unsubscribe
Adresse Typ Bedeutung

control/unsubscribe/input/address

string

Die Quelle, die entfernt werden soll: die Adresse, die setting/stream/address anzeigt. Ein / am Anfang oder Ende zählt nicht.
Tabelle 4. Einstellungen
Adresse Typ Bedeutung

setting/stream/enable, setting/stream/address, setting/stream/tag, setting/stream/queue-size, setting/stream/keep-latest-output

wie die Eingaben

Was control/subscribe/execute oder control/unsubscribe/execute zuletzt angewendet hat, so wie die Einstellungsdatei es speichert. Schreibgeschützt.

setting/settings-hash

string

Der Hash dessen, womit die Ergebnisse erzeugt werden, als 16 Hexadezimalziffern. Schreibgeschützt. Siehe Der Einstellungs-Hash.
Tabelle 5. Ausgaben
Adresse Typ Bedeutung

control/subscribe/output/stream/active

bool

true, solange der Stream läuft.

control/subscribe/output/stream/result

flatbuffers stream_codes

Die aus jedem Frame gelesenen Codes und die Lineage des Frames. Abonnieren Sie den Knoten, um jedes Ergebnis zu erhalten. Siehe Das Ergebnis eines Frames.

control/subscribe/output/stream/last-failure

string

Warum der letzte Frame, der nicht gelesen werden konnte, fehlgeschlagen ist. Nennt die Quelle mit ihrer Adresse, zum Beispiel a frame of 'hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream' failed: …​. Wird geleert, wenn der Stream startet.

control/subscribe/output/stream/statistics/…​

uint64

Zähler des aktuellen oder des letzten Streams, siehe Die Statistik lesen.
execute schreibt in output/results, der Stream in control/subscribe/output/stream/result - Singular. Der Stream schreibt nur mit eingeschaltetem keep-latest-output auch in output/results.

Einrichten

  1. Stellen Sie sicher, dass der Stream des Cam Driver läuft: Sein hdvisionsystems/lumiscan-cam-driver/<camera name>/control/publish/output/stream/active ist true.

  2. Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream, in control/subscribe/input/address. Lassen Sie control/subscribe/input/tag leer, um die Ergebnisse mit dem Namen des Readers zu markieren, oder schreiben Sie ein eigenes Tag hinein.

  3. Abonnieren Sie control/subscribe/output/stream/result.

  4. Setzen Sie control/subscribe/input/enable auf true, und schreiben Sie dann auf control/subscribe/execute. Warten Sie, bis control/subscribe/output/stream/active true ist. Ab dann treffen die Ergebnisse ein.

  5. Zum Stoppen setzen Sie control/subscribe/input/enable auf false und schreiben erneut auf control/subscribe/execute. Der Frame, der gerade gelesen wird, wird zuerst abgeschlossen.

Auf ctrlX OS nehmen Sie dieselben Schreibzugriffe in der Data-Layer-Ansicht der Weboberfläche von ctrlX OS oder aus Ihrem SPS-Programm vor.

Auf einem PC dieselben Schritte mit krxclient, dem Kommandozeilen-Client von LumiScan Keryx, der die Rolle einer SPS übernimmt (siehe Werkzeuge). Ergänzen Sie die Optionen --keryx-backend und --keryx-url, die Ihr Broker benötigt:

krxclient write hdvisionsystems/lumiscan-barcode-reader/control/subscribe/input/address hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream
krxclient write hdvisionsystems/lumiscan-barcode-reader/control/subscribe/input/enable true
krxclient execute hdvisionsystems/lumiscan-barcode-reader/control/subscribe/execute
krxclient subscribe hdvisionsystems/lumiscan-barcode-reader/control/subscribe/output/stream/result --count 5

krxclient subscribe zeigt einen Flatbuffer nur mit seiner Größe an. Es sagt Ihnen, dass Ergebnisse eintreffen, nicht, was sie enthalten.

Gut zu wissen:

  • Der Stream-Modus ist ein Pegel, kein Befehl: Der Stream läuft, solange das angewendete enable true ist.

  • Der Stream kann vor dem Stream des Cam Driver gestartet werden. Ergebnisse treffen ein, sobald Frames eintreffen.

  • Was control/subscribe/execute anwendet, wird in der Einstellungsdatei des Readers gespeichert. Nach einem Neustart der Anwendung startet der Reader so, wie er war: Einer, der gestreamt hat, streamt sofort wieder, ohne dass Ihr Programm etwas ausführen muss. Siehe In der Einstellungsdatei gespeichert.

Die Quelle ändern

Ein Reader hat eine Quelle. Eine SPS oder ein anderer Client ändert sie, während die Anwendung läuft, mit oder ohne laufenden Stream:

  1. Schreiben Sie die neuen Werte in die Eingaben von control/subscribe - nur die, die Sie ändern: Die anderen enthalten, was angewendet ist.

  2. Schreiben Sie auf control/subscribe/execute. Die Eingaben werden gemeinsam geprüft, in der Einstellungsdatei des Readers gespeichert und erst dann angewendet: setting/stream/ zeigt sie sofort an, und ein laufender Stream folgt bei seinem nächsten Zyklus. Eine andere Adresse ersetzt die Quelle; die Frames, die bei der alten noch warteten, werden als übersprungen gezählt. Ein neues Tag, eine neue Warteschlangengröße oder ein neues keep-latest-output braucht kein neues Abonnement: Ein neues Tag markiert das nächste Ergebnis.

  3. Um die Quelle zu entfernen, schreiben Sie ihre Adresse in control/unsubscribe/input/address und dann auf control/unsubscribe/execute. Damit endet der Stream-Modus. Die Eingaben von control/subscribe werden auf das gesetzt, was angewendet wurde: Stream-Modus aus, keine Adresse. Das Tag bleibt: Es markiert die Ergebnisse des Readers, nicht die Quelle.

Kann die Einstellungsdatei nicht geschrieben werden, ändert sich nichts. Siehe In der Einstellungsdatei gespeichert.

Die Methoden antworten:

Ergebnis Wann

DL_OK

Erledigt.

DL_INVALID_VALUE (ctrlX OS), Rejected (PC)

control/subscribe/execute: Stream-Modus ohne Adresse oder eine Warteschlangengröße außerhalb von 1 bis 64. control/unsubscribe/execute: Die Adresse ist nicht die Quelle, oder es gibt keine Quelle.

DL_CREATION_FAILED

Die Einstellungsdatei konnte nicht geschrieben werden, zum Beispiel weil sie kein gültiges JSON ist. Nichts hat sich geändert.

Der Grund für eine Ablehnung wird in das Protokoll der Anwendung geschrieben. Die Namen aller Ergebnisse auf beiden Data Layern sind in Ergebnisse eines Methodenaufrufs aufgeführt.

Kann die Quelle nicht abonniert werden, versucht der Reader es alle 5 Sekunden erneut, solange der Stream läuft, und protokolliert den ersten Fehlschlag.

Das Ergebnis eines Frames

control/subscribe/output/stream/result enthält eine FlatBuffers-Tabelle vom Typ stream_codes (Datei-Identifier HSCD), auf dem Data Layer registriert als types/hdvisionsystems/lumiscan-barcode-reader/stream_codes. Ihr kompiliertes Schema wird als bfbs/stream_codes.bfbs installiert.

Feld Bedeutung

lineage

Woher das Ergebnis stammt, siehe Die Lineage eines Ergebnisses.

result

Die Codes, als CodeDetectResultArray: dieselbe Tabelle, die execute für dasselbe Bild in output/results schreibt, beschrieben in Das Ergebnis. Ein Frame ohne Barcode ergibt ein leeres Array results.

Ein Lesen von control/subscribe/output/stream/result liefert das neueste Ergebnis; vor dem ersten Frame ein leeres. Das letzte Ergebnis bleibt stehen, nachdem der Stream gestoppt wurde.

Ein Frame wird dekodiert, wie execute den Bildknoten dekodiert; es werden also dieselben Pixelformate akzeptiert, siehe Voraussetzungen. Der ganze Frame wird durchsucht. Ein Frame und dasselbe Bild, gelesen über input/image-address, ergeben dieselben Codes.

Ein Frame, der nicht gelesen werden kann - zum Beispiel einer in einem Pixelformat, das der Reader nicht unterstützt, oder einer, dessen Pixel die angegebene Größe nicht ausfüllen -, ergibt kein Ergebnis. Er wird in statistics/failed-frames gezählt, und control/subscribe/output/stream/last-failure sagt, warum.

Die Lineage eines Ergebnisses

lineage.steps listet auf, woher das Ergebnis stammt, der Ursprung zuerst:

  1. Der Schritt der Kamera, wie der Cam Driver ihn erzeugt hat: producer ist die Adresse der Kamera, hdvisionsystems/lumiscan-cam-driver/<camera name>; run, wann der Stream der Kamera gestartet wurde; sequence die Nummer des Frames in diesem Lauf; external_id die eigene Frame-Nummer der Kamera; settings_hash die Einstellungen der Kamera; tag das Tag des Cam Driver für die Kamera, standardmäßig ihre Modul-ID, zum Beispiel camera1.

  2. Der Schritt des Readers: producer ist die Adresse des Readers, hdvisionsystems/lumiscan-barcode-reader; run, wann der Stream des Readers gestartet wurde (jeder Start ist ein neuer Lauf); sequence die Nummer des Ergebnisses im Lauf, ab 1; settings_hash die Einstellungen des Readers, siehe Der Einstellungs-Hash; elapsed_us die Mikrosekunden vom Eintreffen des Frames beim Reader bis zu seinem Ergebnis, Wartezeit eingeschlossen; time_us, wann das Ergebnis erzeugt wurde, in Mikrosekunden seit der Epoche; tag das Tag des Readers, control/subscribe/input/tag, oder lumiscan-barcode-reader, wenn es leer ist.

Ein Ergebnis benennt seinen Frame also genau: die Kamera über producer, den Frame über run und sequence. Um zu erfahren, von welcher Kamera ein Ergebnis stammt, lesen Sie den producer seines ersten Schritts. Eine Lücke in der sequence des Kamera-Schritts zwischen zwei Ergebnissen derselben Kamera sind Frames, die übersprungen wurden, fehlgeschlagen oder verloren gegangen sind.

Eine Lineage enthält höchstens 16 Schritte. Eine längere behält den Ursprung und die neuesten Schritte, und dropped zählt die ausgelassenen Schritte.

Ein Frame ohne Lineage ergibt ein Ergebnis, das nur den Schritt des Readers enthält. Ein Wert auf dem Knoten frame eines Streams, der kein stream_image ist, wird ignoriert und einmalig protokolliert.

Der Einstellungs-Hash

setting/settings-hash und der settings_hash des Reader-Schritts in jedem Ergebnis identifizieren, womit die Ergebnisse erzeugt werden. Der Knoten zeigt den Hash als 16 Hexadezimalziffern; der Schritt enthält denselben Wert als Zahl.

Der Reader hat keine Einstellung, die ein Lesen verändert; der Hash deckt also nur den Codetyp sowie Name und Version der Anwendung ab: Er ändert sich, wenn die Anwendung aktualisiert wird. Er deckt nicht den Stream-Modus, die Quelle, die Warteschlangengröße oder keep-latest-output ab, die die Frames auswählen und takten.

Wenn ein Hash zum ersten Mal auftritt, schreibt der Reader die Einstellungen, für die er steht, nach settings-history/barcode-reader-<hash>.json im Konfigurationsverzeichnis der Anwendung, sodass ein in einem Ergebnis gefundener Hash später nachgeschlagen werden kann. Die Anwendung löscht diese Dateien nicht. Eine Datei sieht so aus:

{
    "format": 1,
    "settings": {
        "code-type": "bar-code",
        "software.name": "lumiscan-barcode-reader",
        "software.version": "<version>"
    },
    "settingsHash": "<16 hex digits>"
}

Die Statistik lesen

Die Zähler beginnen bei jedem Start des Streams bei null, werden etwa viermal pro Sekunde aktualisiert, solange er läuft, und behalten ihre letzten Werte, nachdem er gestoppt wurde. Alle Adressen beginnen mit control/subscribe/output/stream/statistics/.

Zähler Bedeutung

elapsed-ms

Millisekunden seit dem Start des Streams. Teilen Sie einen Zähler dadurch, um eine Rate zu erhalten.

received-frames

Frames, die das Abonnement geliefert hat.

processed-frames

Gelesene Frames, jeder mit einem auf control/subscribe/output/stream/result veröffentlichten Ergebnis.

skipped-frames

Frames, die nie gelesen wurden: von neueren aus der Warteschlange verdrängt, während ein Frame gelesen wurde (siehe Die Warteschlangengröße), oder noch wartend, als die Quelle ersetzt oder entfernt wurde.

failed-frames

Frames, die nicht gelesen werden konnten. control/subscribe/output/stream/last-failure sagt, warum der letzte fehlgeschlagen ist, und das Protokoll nennt die Fehlschläge, höchstens eine Zeile alle 5 Sekunden.

lost-frames

Frames, die verloren gingen, bevor sie eintrafen, ermittelt aus Lücken in der sequence der Kamera innerhalb eines Laufs ihres Streams. Eine neue Quelle oder ein neuer Lauf des Kamera-Streams beginnt die Zählung von vorn.

processing-us

Mikrosekunden, die alle Lesevorgänge zusammen gedauert haben. Teilen Sie durch processed-frames für den Mittelwert.

Frames, die beim Stoppen des Streams noch warten, werden verworfen, ohne gezählt zu werden.

In der Einstellungsdatei gespeichert

Stream-Modus und Quelle sind Einstellungen des Readers. Sie werden im Abschnitt stream der Einstellungsdatei des Readers gespeichert, barcode-reader.json im Konfigurationsverzeichnis der Anwendung.

control/subscribe/execute und control/unsubscribe/execute speichern dort selbst, was sie anwenden, alle fünf Werte in einem Schreibvorgang, bevor sie sie anwenden. Kann die Datei nicht geschrieben werden, antwortet die Methode mit DL_CREATION_FAILED, und nichts ändert sich. Nach einem Neustart abonniert der Reader dieselbe Quelle und startet, wenn stream.enable true ist, seinen Stream sofort: Niemand muss etwas ausführen.

Das Speichern ändert nur den Abschnitt stream; der Rest der Datei bleibt, wie er war, Kommentare eingeschlossen. Der Reader legt die Datei an, wenn es keine gibt.

Das Konfigurationsverzeichnis:

Plattform Konfigurationsverzeichnis

ctrlX OS

/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-barcode-reader

PC (Windows)

%APP_RESOURCE_DIR%\etc\lumiscan-barcode-reader; ohne APP_RESOURCE_DIR C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-barcode\etc\lumiscan-barcode-reader

Die Datei enthält einen Abschnitt, stream. Ein Beispiel; auf einem PC ist es das Beispiel, das die Anwendung mit --generate-settings schreibt, siehe Mit einem Beispiel beginnen:

{
    // The settings of the Barcode Reader, read once, at the start: the image stream it reads codes in.
    // control/subscribe/execute and control/unsubscribe/execute save what they change here before
    // they apply it, the rest of the file left as it is, comments included.
    "$schema": "schemas/barcode-reader.schema.json",
    "stream": {
        // Stream mode: read every frame of the source as it arrives. Off if left out.
        "enable": false,
        // The one image stream to read: its folder.
        "address": "hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream",
        // "tag" (left out here): what marks the codes it reads, in their lineage - the reader's name,
        // lumiscan-barcode-reader, if left out.
        // How many frames may wait while a frame is read: 1 to 64, 1 if left out.
        "queueSize": 1,
        // Each stream result also on output/results, as execute writes it. Off if left out.
        "keepLatestOutput": false
    }
}
Schlüssel Erforderlich Bedeutung

enable

Nein

Stream-Modus: true startet den Stream beim Start der Anwendung. Benötigt eine address. false, wenn weggelassen.

address

Nein

Die eine Quelle: der Stream-Ordner einer Kamera.

tag

Nein

Was die Ergebnisse des Readers markiert: das tag des Reader-Schritts in ihrer Lineage. Der Name des Readers, lumiscan-barcode-reader, wenn weggelassen.

queueSize

Nein

Wie viele Frames warten dürfen: 1 bis 64, 1, wenn weggelassen.

keepLatestOutput

Nein

true, um jedes Stream-Ergebnis zusätzlich in output/results zu schreiben. false, wenn weggelassen.

onEntry

Nein

Die Schritte, die auf jeden Frame beim Eintreffen angewendet werden, jeder ein Objekt mit einem kind, wie sie der Abschnitt stream jeder LumiScan-Anwendung hat. Diese Anwendung hat noch keine: Lassen Sie ihn weg oder leer ([]). Ein Schritt startet den Reader außerhalb des Stream-Modus, mit einer Warnung im Protokoll; beim Speichern bleibt er erhalten.

control/subscribe/execute und control/unsubscribe/execute schreiben alle fünf.

Gut zu wissen:

  • Die Datei wird einmal gelesen, beim Start der Anwendung. Von Hand vorgenommene Änderungen an der Datei wirken beim nächsten Start.

  • Ein Wert, der nicht verwendet werden kann, wird ignoriert und protokolliert: ein enable oder keepLatestOutput, das nicht true oder false ist, eine address oder ein tag, das kein String ist, eine queueSize außerhalb von 1 bis 64 (1 wird verwendet). Stream-Modus ohne address wird ignoriert: Der Reader startet außerhalb des Stream-Modus.

  • Der Abschnitt subscriptions früherer Versionen wird nicht mehr gelesen, und der Reader protokolliert, dass er umgezogen ist: Geben Sie die Quelle als address an.

  • Eine Datei, die kein gültiges JSON ist, wird ignoriert und protokolliert.

Die Warteschlangengröße

control/subscribe/input/queue-size legt fest, wie viele Frames warten dürfen, während ein Frame gelesen wird: 1 bis 64, standardmäßig 1. Der Wert wird als stream.queueSize gespeichert, und setting/stream/queue-size zeigt den verwendeten Wert an. Ein Frame, der eintrifft, wenn so viele warten, verdrängt den ältesten von ihnen, was in statistics/skipped-frames gezählt wird. Eine neue Warteschlangengröße gilt ab dem nächsten eintreffenden Frame, ohne neues Abonnement.

Warteschlangengröße Wirkung

1 (Standard)

Der Reader liest den neuesten Frame. Er fällt nie zurück; ist das Lesen langsamer als die Kamera, überspringt er Frames.

Mehr als 1

Kurze Frame-Schübe werden vollständig gelesen, und weniger Frames werden übersprungen. Ist das Lesen über längere Zeit langsamer als die Kamera, fällt der Reader zurück: Er liest Frames, die bis zu so viele Lesevorgänge alt sind. Jeder wartende Frame hält ein ganzes Bild im Speicher.

Das neueste Ergebnis behalten

Mit control/subscribe/input/keep-latest-output true - angewendet durch control/subscribe/execute, gespeichert als stream.keepLatestOutput - schreibt der Reader jedes Stream-Ergebnis zusätzlich in output/results, so wie execute es schreibt, sobald das Ergebnis auf control/subscribe/output/stream/result veröffentlicht ist. Ein Client, der output/results liest, hat dann das Ergebnis des neuesten Frames, ohne den Stream zu abonnieren. Es kostet eine Kopie jedes Ergebnisses. Standardmäßig aus.

execute, während der Stream läuft

execute und der Stream behindern sich nicht. Jeder Frame wird von einem eigenen Detektor gelesen, wie jeder Aufruf von execute, und nichts wird zwischen den beiden geteilt: execute kann jederzeit aufgerufen werden, während der Stream läuft, und ein Frame wartet nie darauf.

Einschränkungen

  • input/parameter wird weder von execute noch vom Stream gelesen.

  • Der Stream wurde nur unter Windows mit LumiScan Keryx und simulierten Bildern getestet. Er wurde nicht unter Linux (ctrlX OS oder Ubuntu), auf dem ctrlX Data Layer oder mit einer echten Kamera geprüft.

  • LumiScan Cockpit zeichnet die Ergebnisse des Streams noch nicht.

  • Von Hand vorgenommene Änderungen an der Einstellungsdatei wirken beim nächsten Start der Anwendung.

Mit einem Beispiel beginnen (PC)

Auf einem PC schreibt der Barcode Reader ein Beispiel seiner Einstellungen in einen Ordner Ihrer Wahl und beendet sich, ohne zu starten. Unter Windows zum Beispiel:

lumiscan-barcode --generate-settings C:\work\barcode-reader-settings

Ohne Ordner (-g allein) schreibt er in den aktuellen Ordner. Das Beispiel ist die Einstellungsdatei barcode-reader.json: Stream-Modus aus, der Stream von camera1 des Cam Driver als Quelle, die standardmäßige Warteschlangengröße und keep-latest-output aus. Daneben, in schemas/, liegen das Schema, das sie in "$schema" nennt, barcode-reader.schema.json, und stream.schema.json, das den Abschnitt stream beschreibt; ein Editor, der JSON Schema versteht, kann die Datei dagegen prüfen. Kopieren Sie den Ordner schemas mit. Vorhandene Dateien werden nie überschrieben: Liegt eine von ihnen bereits im Ordner, wird nichts geschrieben, und der Barcode Reader sagt, welche.

Der Barcode Reader nennt dann den Ordner, aus dem er seine Einstellungen liest, unter Windows standardmäßig C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-barcode\etc\lumiscan-barcode-reader. Bearbeiten Sie das Beispiel, kopieren Sie es dorthin, und starten Sie den Barcode Reader.