FAQ

Er liest Aztec-Codes, die kompakte 2D-Symbologie mit einem Bullseye-Suchmuster in der Mitte, die keine Ruhezone benötigt. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Begrenzung auf einen Code pro Lauf. Es sind keine Vorlage, kein Referenzbild, kein Trainingsschritt und keine Konfiguration nötig: 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 genannten Bildknoten, den eine andere Anwendung auf demselben Data Layer veröffentlicht - auf ctrlX OS auf derselben ctrlX CORE oder demselben ctrlX IPC (der 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ß-/Kleinschreibung verglichen, und bei den Bayer-Namen darf der Unterstrich weggelassen werden (BayerGR8 und bayer_gr8 sind dasselbe Format). Bayer-Bilder werden vor der Suche in Farbbilder umgewandelt. Jedes andere Pixelformat wird abgelehnt, und der Lauf 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-aztec-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 zurück, als Strings; 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, nicht, dass ein Fehler vorliegt.

Das Ergebnis

Dieser Reader veröffentlicht keinen Knoten status-code oder status-text und gibt keinen Identifier zurück. Ein Lauf 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 Lauf lässt output/results unverändert; der Knoten enthält weiterhin die Codes des vorherigen Laufs.

Prüfen Sie das Protokoll der Anwendung, 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 Lauf 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 Schreibvorgang darauf ändert also nichts; der Bild-Stream liest ihn ebenfalls nicht. Es gibt keine Region of Interest: Jeder Lauf durchsucht das ganze 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 aztec-code auf 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 Schreibvorgang auf execute kehrt zurück, wenn die Suche abgeschlossen ist. Wie lange das dauert, hängt von der Bildgröße ab, da bei jedem Lauf das ganze Bild durchsucht wird.

Voraussetzungen

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

Codes auf einem Bild-Stream lesen, Streams

aztec-code-reader.json liegt im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS /var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-aztec-code-reader; auf einem PC (Windows) %APP_RESOURCE_DIR%\etc\lumiscan-aztec-code-reader oder ohne APP_RESOURCE_DIR C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-aztec-code\etc\lumiscan-aztec-code-reader. Auf einem PC schreibt lumiscan-aztec-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 LumiScan-FAQ der gesamten Dokumentation 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