---
title: "Beschreibung"
product: "LumiScan Text Reader"
component: "lumiscan-text-reader-de"
version: "1.1.0"
display_version: "1.1.0.6"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/description.html"
---

# Beschreibung – LumiScan Text Reader

LumiScan Text Reader liest gedruckten Text aus einem Kamerabild: Teilenummern, Chargencodes, Datumscodes, Etiketten.

Sie richten ihn auf einen Bildknoten, geben an, wo der Text steht und was er enthalten darf, und er meldet den Text zusammen mit einer Konfidenz für jedes Wort.

Er läuft auf ctrlX OS (ctrlX CORE oder ctrlX IPC) mit dem ctrlX Data Layer und auf einem PC (Windows 11 oder Ubuntu 24.04) mit LumiScan Keryx, dem Data Layer von HD Vision Systems für PCs. Seine Knoten sind auf beiden gleich, siehe [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/datalayer-reference.html).

Was in jeder LumiScan-App gleich ist - wie Adressen aufgebaut sind, die Aufrufmuster Handshake, Execute und Stream, Statuscodes, Einstellungen und Werkzeuge - ist im Handbuch [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/index.html) beschrieben. Dieses Handbuch behandelt nur das, was spezifisch für LumiScan Text Reader ist; seine eigenen Knoten sind in der [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/datalayer-reference.html) aufgelistet.

> [!NOTE]
> Ist die Kennzeichnung ein **Code** und kein Text - Data Matrix, QR, Aztec oder ein Barcode -, verwenden Sie die Schwester-App für diesen Code. Ein Code trägt seine eigene Fehlerkorrektur: Er wird entweder exakt dekodiert oder schlägt fehl; ihn als Text zu lesen ist langsamer und weniger zuverlässig.

## Text ist kein Code, und das ändert die Nutzung

Das ist das Wichtigste, was Sie verstehen sollten, bevor Sie die Anwendung in die Produktion nehmen.

Ein Code Reader liefert einen dekodierten Wert oder nichts. Ein OCR-Leser liefert immer **etwas**, und eine Fehllesung sieht genauso aus wie ein korrektes Leseergebnis:

- jedes Wort kommt mit einer **Konfidenz** zurück, nicht mit einer Garantie;
- ein unbekanntes Zeichen wird **ersetzt** statt abgelehnt - `O` statt `0`, `S` statt `5`;
- dasselbe Etikett wird unterschiedlich gelesen, je nachdem, wie es zugeschnitten wurde und welche Zeichen erlaubt waren.

Die Anwendung ist darauf ausgelegt. Zwei Einstellungen machen aus einem plausiblen Leseergebnis ein vertrauenswürdiges, und beide stehen standardmäßig auf dem freizügigen Wert, damit eine frische Installation Ihnen zeigt, was sie tatsächlich sehen kann:

| Einstellung | Wirkung |
| --- | --- |
| `input/characters/mode` | Schränkt ein, welche Zeichen zurückgegeben werden dürfen. Eine Teilenummer, die immer nur aus Ziffern besteht, kann mit `DIGITS` gelesen nicht mit einem `O` zurückkommen. Das beseitigt eine ganze Klasse von Fehlern, statt sie nachträglich zu filtern. |
| `input/min-score` | Die Konfidenz, die ein Wort erreichen muss, um gemeldet zu werden. Beim Standardwert `0` wird alles gemeldet, auch Vermutungen, denen die Engine kaum traut. |

Setzen Sie beide, bevor Sie sich auf ein Leseergebnis verlassen. Siehe [Genau lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/reading-accurately.html).

## Was ein Leseergebnis enthält

`output/result` enthält den gesamten Text, so wie die Engine ihn angeordnet hat, **und** eine Liste pro Wort mit einer Konfidenz und einer Position für jedes Wort. Sie beantworten unterschiedliche Fragen:

- lesen Sie den gesamten Text, wenn die **Form** zählt - eine mehrzeilige Adresse, ein Etikett mit Kopfzeile;
- lesen Sie die Wortliste, wenn der **Inhalt** zählt und eine falsche Antwort schlimmer ist als keine.

Ebenfalls im Ergebnis: Sprache, Engine und Layout, die **tatsächlich** verwendet wurden. Der letzte Punkt ist wichtig, weil eine Sprache, deren Modell nicht installiert ist, stillschweigend durch Englisch ersetzt und nicht abgelehnt wird - siehe [Sprachmodelle](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/language-models.html).

## Ein leeres Leseergebnis ist kein Fehler

Ein Durchlauf, der nichts findet, meldet Erfolg mit null Wörtern. Das ist die normale Antwort für einen leeren Träger, ein falsch herum liegendes Teil oder ein Etikett außerhalb des Bildes.

Entscheiden Sie anhand der Wortanzahl, nicht anhand des Statuscodes, ob ein Teil Text trug. Jeder Grund, aus dem ein Durchlauf wirklich fehlschlagen kann - eine Kamera, die nicht antwortet, eine unbrauchbare Einstellung, eine Engine, die nicht starten konnte -, wird stattdessen als negativer Statuscode gemeldet.

> [!IMPORTANT]
> In einem Fall wird ein Leseergebnis leer, obwohl der Text einwandfrei lesbar ist: ein Farbbild, in dem ein Foto oder eine andere farbenfrohe Szene mit im Bild ist. Ist ein Leseergebnis leer und Sie können den Text im Bild sehen, setzen Sie `input/preprocess = GRAYSCALE`, bevor Sie etwas anderes untersuchen - siehe [Genau lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/reading-accurately.html).