FAQ

Er liest QR-Codes, die 2D-Symbologie mit einem quadratischen Finder-Muster in drei Ecken. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Begrenzung auf einen Code pro Durchlauf. Es wird keine Vorlage, kein Referenzbild, kein Trainingsschritt und keine Konfiguration benötigt: Sie geben dem Reader die Adresse eines Bildes und rufen execute auf.

Beschreibung

Der Reader spricht nicht selbst mit einer Kamera. Er liest den in input/image-address angegebenen Bildknoten, den eine andere Anwendung auf demselben Data Layer veröffentlicht - auf ctrlX OS auf demselben ctrlX CORE oder ctrlX IPC (ein Zugriff auf einen entfernten Data Layer wird nicht unterstützt), auf einem PC über denselben LumiScan-Keryx-Broker -, normalerweise LumiScan Cam Driver, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/output/image. Der Knoten muss data (rohe, unkomprimierte uint8-Pixeldaten), width, height und pixel-type (Name des GenICam-Pixelformats) bereitstellen. Geben Sie die Adresse des Bildknotens selbst an, nicht die seines Kindknotens data: Der Reader hängt /data, /width, /height und /pixel-type an.

Voraussetzungen, Einen Code lesen

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, Bayer_GR8, Bayer_RG8, Bayer_GR12 und Bayer_RG12. Der Name wird ohne Rücksicht auf Groß- und Kleinschreibung abgeglichen, und der Unterstrich darf in den Bayer-Namen fehlen (BayerGR8 und bayer_gr8 sind dasselbe Format). Bayer-Bilder werden vor der Suche in Farbe umgewandelt. Jedes andere Pixelformat wird abgelehnt, und der Durchlauf liefert kein Ergebnis. Die Bilddaten müssen für das angegebene Format mindestens width x height x bytes-per-pixel Bytes umfassen; ein kürzerer Puffer wird abgelehnt.

Voraussetzungen

Alle Pfade sind relativ zu hdvisionsystems/lumiscan-qr-code-reader.

Einen Code lesen

output/results ist ein FlatBuffer (CodeDetectResultArray.results) mit einem Eintrag pro Code: center (ein Point2f mit x und y in Bildpixeln), text (der dekodierte Inhalt), score (wie sicher das Leseergebnis ist) und polygons (die Eckpunkte, die den Code umreißen). Auf ctrlX OS kommen die Zahlen über die ctrlX REST API in Anführungszeichen, als Strings, zurück; parsen Sie sie also als Zahlen. center und text sind immer vorhanden; polygons kann bei einem Eintrag fehlen, was bedeutet, dass kein Umriss angegeben wurde - kein Fehler.

Das Ergebnis

Dieser Reader veröffentlicht keinen Knoten status-code oder status-text und gibt keinen Identifier zurück. Ein Durchlauf schlägt fehl, wenn das Bild nicht gelesen werden kann: keine Adresse gesetzt, eine Adresse, die sich nicht auflösen lässt, ein fehlender oder zu kurzer data-Puffer oder ein nicht unterstütztes Pixelformat. Ein fehlgeschlagener Durchlauf lässt output/results unverändert; es enthält weiterhin die Codes des vorherigen Durchlaufs.

Prüfen Sie das Anwendungsprotokoll, in das der Grund geschrieben wird (auf ctrlX OS das Systemprotokoll von ctrlX OS, auf einem PC die Konsolenausgabe der App), oder lesen Sie output/results vor und nach dem Durchlauf und vergleichen Sie.

Einen Code lesen, Data-Layer-Referenz

Nein, nicht in dieser Version. input/parameter enthält keine Einstellungen (seine Tabelle DetectionParameters ist leer), ein Schreibzugriff darauf ändert also nichts; auch der Bild-Stream liest ihn nicht. Es gibt keine Region of Interest: Jeder Durchlauf durchsucht das gesamte Bild. Es gibt keine Module: ein Reader pro Installation, unter einem einzigen Basispfad. Es gibt auch kein Ergebnisbild; verwenden Sie LumiScan Cockpit, um die Codes zu sehen.

Data-Layer-Referenz

Öffnen Sie LumiScan Cockpit. Es führt den Reader als Ansicht namens qr-code und zeichnet ein Rechteck um jeden Code, beschriftet mit dem dekodierten Text und dem Score. Ein Code, der gefunden, aber nicht dekodiert wurde, hat keinen Text und wird nur mit seinem Score beschriftet. Cockpit zeichnet die Ergebnisse des Bild-Streams noch nicht.

Das Ergebnis

Das Lesen ist synchron: Der Schreibzugriff auf execute kehrt zurück, wenn die Suche beendet ist. Wie lange das dauert, hängt von der Bildgröße ab, da bei jedem Durchlauf das gesamte Bild durchsucht wird.

Voraussetzungen

Verwenden Sie den Bild-Stream (experimentell). Nur control/subscribe/execute wendet seine Eingaben an: Das Schreiben einer Eingabe allein ändert nichts. Alle Pfade sind relativ zu hdvisionsystems/lumiscan-qr-code-reader.

Codes auf einem Bild-Stream lesen, Streams

qr-code-reader.json liegt im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS /var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-qr-code-reader; auf einem PC (Windows) %APP_RESOURCE_DIR%\etc\lumiscan-qr-code-reader oder ohne APP_RESOURCE_DIR C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-qr-code\etc\lumiscan-qr-code-reader. Auf einem PC schreibt lumiscan-qr-code --generate-settings <folder> ein Beispiel. Die Datei wird einmal gelesen, beim Start der Anwendung.

In der Einstellungsdatei gespeichert

Ist eine Advanced-Lizenz verfügbar, verwendet die Anwendung sie automatisch. Ist keine verfügbar, läuft sie mit den Standard-Funktionen, statt den Start zu verweigern.

Voraussetzungen, FAQ zur Lizenzierung

Ein Lizenzplatz deckt den Reader ab, da es einen Reader pro Installation gibt. Bezugswege:

Voraussetzungen, FAQ zur Lizenzierung

Siehe die übergreifende LumiScan-FAQ und für den Data Layer auf beiden Plattformen die Data-Layer-FAQ. Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen an licenses@hdvisionsystems.com.

FAQ zur Lizenzierung