Voraussetzungen

Lizenz

Wie LumiScan Text Reader lizenziert wird, hängt davon ab, wo Sie es gekauft haben und wo es läuft:

Gekauft bei Läuft auf Lizenzierung

HD Vision Systems

Windows 11 oder Ubuntu 24.04

Die Lizenz liegt auf Ihrem LumiScan Key. Sie ist ein Einmalkauf und wird nicht verlängert.

ctrlX Store

Windows 11

Die Lizenz liegt in ctrlX WORKS. Zusätzlich ist der LumiScan Key erforderlich; er schützt die Software vor Reverse Engineering.

ctrlX Store

ctrlX OS (ctrlX CORE oder IPC)

ctrlX-Lizenz SWL-W-XCx-TEXTxxRDSxHDVSx-V1NN, eine Lizenz pro zehn Module.

Jedes Gerät, auf dem LumiScan Text Reader gleichzeitig läuft, benötigt einen eigenen LumiScan Key. Keys können zwischen Geräten ausgetauscht werden.

Wie Sie die CodeMeter Runtime installieren und Lizenzen anfordern, verlängern und an einem anderen PC verwenden, steht in LumiScan Lizenzierung.

Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund wird in das Systemprotokoll geschrieben.

Eine Plattform und ihr Data Layer

Plattform Data Layer

ctrlX OS (ctrlX CORE oder ctrlX IPC)

ctrlX Data Layer, bereitgestellt von ctrlX OS

ein PC mit Windows 11 oder Ubuntu 24.04

LumiScan Keryx, der Data Layer von HD Vision Systems für PCs

Auf ctrlX OS ist für den Data Layer nichts zu installieren.

Auf einem PC startet die Anwendung den LumiScan-Keryx-Broker, wenn keiner läuft; Installation und Einrichtung von LumiScan Keryx sind in LumiScan Keryx auf einem PC beschrieben.

Eine Bildquelle auf demselben Gerät

Die Anwendung liest ihre Bilder vom Data-Layer-Bildknoten einer anderen Anwendung. Diese Anwendung muss auf demselben Gerät laufen wie der Text Reader - derselben ctrlX CORE oder demselben ctrlX IPC oder demselben PC. Ein entfernter Data-Layer-Zugriff wird nicht unterstützt.

In der Praxis ist das LumiScan Cam Driver, aber jede Anwendung funktioniert, solange ihr Bildknoten diese vier Kindknoten bereitstellt:

Knoten Typ Beschreibung

data

Array aus uint8

Rohe, unkomprimierte Pixeldaten

width

uint64

Bildbreite in Pixeln

height

uint64

Bildhöhe in Pixeln

pixel-type

string

Name des GenICam-Pixelformats

Unterstützte Pixelformate

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, BayerGR8, BayerGR12, BayerRG8, BayerRG12.

Bayer-Bilder werden vor dem Lesen in Farbe umgewandelt und 12-Bit-Bilder auf 8 Bit herunterskaliert.

Jedes andere Pixelformat wird mit Statuscode -3 abgelehnt.

Sprachmodelle

Die Anwendung wird mit installiertem Englisch (eng) und dem Orientierungsmodell (osd) ausgeliefert; das reicht, um Text in lateinischer Schrift ohne weitere Einrichtung zu lesen.

Andere Sprachen benötigen ihre Tesseract-Datei .traineddata in einem Verzeichnis, das die Anwendung lesen kann - auf ctrlX OS funktioniert dank der Schnittstelle removable-media ein USB-Stick -, und system/set-tessdata-dir muss darauf zeigen. Siehe Sprachmodelle.

Bildqualität

OCR stellt höhere Anforderungen an das Bild als das Lesen von Codes, und keine Einstellung holt Text zurück, den die Kamera nicht erfasst hat. Als Faustregel:

  • Zeichen mindestens 20 Pixel hoch, bei kleinem oder verrauschtem Druck 30 oder mehr;

  • guter Kontrast zwischen Kennzeichnung und Hintergrund;

  • der Text im Fokus und nicht von der Beleuchtung überstrahlt;

  • der Text ungefähr aufrecht, sofern Sie kein Layout mit Orientierungserkennung aktivieren.

Nadeldruck- und lasergravierte Kennzeichnungen sind schwieriger als gedruckter Text. Hat engine = DEFAULT damit Probleme, lohnt sich LEGACY als erster Versuch.

Speicher

Die Anwendung speichert nichts außer ihrer Modulliste und deren Einstellungen - einige Kilobyte JSON im Konfigurationsverzeichnis der Anwendung. Auf ctrlX OS ist dieses Verzeichnis Teil der aktiven Solution. Die Sprachmodelle werden mit der Anwendung installiert und nicht beschrieben. Wo das Verzeichnis auf jeder Plattform liegt, steht in In der Einstellungsdatei gespeichert.

Der Bild-Stream (experimentell) fügt daneben einen Ordner hinzu, settings-history/: eine kleine JSON-Datei für jeden Einstellungs-Hash, den ein Modul veröffentlicht, nie gelöscht. Siehe Einen Bild-Stream verarbeiten.

Zeitverhalten

Das Lesen ist synchron: Der Aufruf von execute kehrt zurück, wenn das Lesen abgeschlossen ist.

Wie lange das dauert, hängt vor allem davon ab, wie viel Bild die Engine erhält. Deshalb ist input/crop die erste Einstellung, zu der Sie greifen sollten, wenn ein Zyklus zu langsam ist - ein enger Ausschnitt um das Etikett ist schneller und genauer als das ganze Bild. Die Layouts AUTO_OSD und SPARSE_OSD kosten deutlich mehr als die anderen, weil sie ein zweites Modell laden und vor dem Lesen die Orientierung bestimmen.

Siehe Genau lesen.