--- title: "FAQ" description: "Häufige Fragen zu LumiScan Text Reader - Bildquelle und Bildqualität, einen Lesevorgang durchführen, Sprachmodelle, der Bild-Stream, Statuscodes und Lizenzierung." 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/faq.html" --- # FAQ – LumiScan Text Reader Kurze Antworten auf häufige Fragen zu LumiScan Text Reader. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html) beschrieben. > [!TIP] > Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-read-text`). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html) danach. ## Voraussetzungen und Einrichtung ### Welche Bildquelle und welche Pixelformate braucht der Text Reader? {#faq-image-source} - **Antwort:** Die Anwendung liest den Bildknoten einer anderen Anwendung, die auf **demselben Gerät** läuft - derselben ctrlX CORE oder demselben ctrlX IPC oder demselben PC (ein entfernter Data-Layer-Zugriff wird nicht unterstützt), 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` bereitstellen. Unterstützte Pixelformate sind `Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `BayerGR8`, `BayerGR12`, `BayerRG8` und `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. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/requirements.html) ### Welche Bildqualität braucht OCR? {#faq-image-quality} - **Antwort:** 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; - Text im Fokus und nicht von der Beleuchtung überstrahlt; - Text ungefähr aufrecht, sofern Sie kein Layout mit Orientierungserkennung verwenden. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/requirements.html) ## Text lesen ### Wie führe ich einen Lesevorgang durch und werte das Ergebnis aus? {#faq-read-text} - **Antwort:** Setzen Sie `/read-text/input/input-image-address`, schreiben Sie auf `/read-text/execute` (ein blockierender Aufruf) und prüfen Sie `output/status-code`. Bei `1` lesen Sie `output/result`: `text` ist das gesamte Leseergebnis, wie die Engine es angeordnet hat, und wird **nicht** nach `min-score` gefiltert; `words[]` enthält jedes Wort mit seinem `score` und seinem Rahmen, gefiltert nach `min-score`; `word_count`, `mean_score` sowie `language`, `engine` und `layout`, wie sie tatsächlich verwendet wurden, werden ebenfalls gemeldet. In der Produktion prüfen Sie `word_count` und `words[0].score`, bevor Sie `words[0].text` mit dem erwarteten Wert vergleichen. - **Mehr:** [Text lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/reading-text.html), [Anleitung: Eine Bauteilkennzeichnung aus einem Kamerabild lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/how-tos/read-a-part-marking-from-a-camera-image.html) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html) beschrieben: - [Statuscode 1, aber keine Wörter](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-empty-reading) - [Das Leseergebnis ist leer, obwohl der Text in einem Farbbild deutlich sichtbar ist](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-empty-colour-image) - [Ziffern werden als Buchstaben gelesen (O statt 0, S statt 5)](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-digits-letters) - [Das Leseergebnis enthält zusätzliche Wörter aus dem Hintergrund](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-extra-words) - [Nadeldruck- oder lasergravierte Kennzeichnung wird schlecht gelesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-dot-matrix) - [Das Lesen ist zu langsam](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-reading-too-slow) - [Statuscode -2 (eine Einstellung ist unbrauchbar)](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-status-minus-2) - [Statuscode -3 (Bild kann nicht gelesen werden)](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-status-minus-3) - [Statuscode -7 (OCR-Engine konnte nicht starten)](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-status-minus-7) - [Ein Lesevorgang mit AUTO_OSD oder SPARSE_OSD wird abgelehnt ("also needs osd.traineddata beside …")](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-osd-beside-language) - [Ein hochgeladenes Modell erscheint nicht auf system/languages](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-languages-list) - [Der Text wird in einer anderen Sprache als input/language gelesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#ts-wrong-language) - [read-text antwortet mit -1 (belegt), während der Stream läuft](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-stream-busy) - [Ein Stream-Bild schlägt fehl mit "the frame was read with 'eng' instead and its result dropped"](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-stream-language-dropped) - [Meine Einstellungen oder Module sind nach einem Neustart weg](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/troubleshooting.html#faq-settings-lost) ## Sprachmodelle ### Wie lese ich eine andere Sprache? {#faq-add-language} - **Antwort:** Englisch (`eng`) und `osd` werden mit der Anwendung ausgeliefert. - Laden Sie die `.traineddata`-Datei von `github.com/tesseract-ocr/tessdata_fast` (kleiner und schneller, der richtige Standard für Bauteilkennzeichnungen) oder `tessdata_best` herunter. - Laden Sie sie, ohne sie umzubenennen, in das auf `system/tessdata-dir` genannte Verzeichnis hoch: auf ctrlX OS über die ctrlX-Dateischnittstelle, auf einem PC, indem Sie die Datei dorthin kopieren. - Setzen Sie `/read-text/input/language` auf den Dateinamen ohne `.traineddata`, zum Beispiel `deu`. Die Codes haben nicht alle drei Buchstaben (zum Beispiel `chi_sim`). - Das Modell ist beim allernächsten Lesevorgang nutzbar, ohne Neustart. Hochladen entfernt nie die mitgelieferten Modelle. - **Mehr:** [Sprachmodelle](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/language-models.html) ### Ich habe eine Modelldatei ersetzt - verwendet der Leser die neue? {#faq-replaced-model} - **Antwort:** Ja, ab dem nächsten `read-text`, ohne Neustart. Die Erkennungs-Engine wird einmal pro Modul aufgebaut und behalten, aber vor jedem Lesen prüft der Leser Größe und Zeitstempel der Modelldatei und vergleicht, wenn sich eines davon geändert hat, ihren Inhalt mit dem, aus dem die Engine aufgebaut wurde. Ein geändertes Modell wird erneut geladen; das Protokoll meldet `The '' model in '' changed on disk; loading it again`. Auch ein Bild-Stream liest das nächste Bild mit dem Modell, wie es auf dem Datenträger liegt. - **Ursache:** Schlägt ein Lesevorgang direkt nach dem Ersetzen mit `-7` fehl, konnte die Datei noch nicht geladen werden - zum Beispiel bei einem noch laufenden Upload. - **Lösung:** Lesen Sie erneut, sobald der Upload abgeschlossen ist; dieser Lesevorgang lädt das neue Modell. - **Mehr:** [Sprachmodelle](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/language-models.html) ## Bild-Stream ### Wie lese ich den Text auf jedem Bild eines Kamera-Streams? {#faq-stream} - **Antwort:** Abonnieren Sie mit einem Modul den Stream des Cam Driver (experimentell): Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, nach `/control/subscribe/input/address`, setzen Sie `control/subscribe/input/enable` auf `true` und schreiben Sie auf `control/subscribe/execute`. Jedes Bild wird mit den Eingaben von `read-text` gelesen, und ein Ergebnis pro Bild wird auf `control/subscribe/output/stream/result` veröffentlicht. Um das neueste Ergebnis als normales `read-text/output/result` zu lesen, setzen Sie `control/subscribe/input/keep-latest-output` auf `true`. - **Mehr:** [Text auf einem Bild-Stream lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/processing-an-image-stream.html), [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html) ## Statuscodes und Fehler ### Woran erkenne ich, ob ein Lesevorgang funktioniert hat, und wo steht der Grund für einen Fehler? {#faq-status-codes} - **Antwort:** Prüfen Sie das Vorzeichen von `output/status-code`: größer als 0 ist Erfolg, `0` bedeutet, dass die Operation seit dem Start der Anwendung nicht gelaufen ist, kleiner als 0 bedeutet, dass sie fehlgeschlagen ist und nichts erzeugt hat. Der Grund steht auf `output/status-text`. Ein fehlgeschlagener Schreibvorgang auf `execute` antwortet nur mit einem Statuscode (über REST ein bloßes `400`), lesen Sie also anschließend `output/status-text`; der Text steht auch im Anwendungsprotokoll: auf ctrlX OS im ctrlX Logbook oder `journalctl`, auf einem PC in der Konsolenausgabe der Anwendung. `-1` bedeutet, dass das Modul belegt war; nichts wurde getan, und das vorherige Leseergebnis bleibt unberührt. Jedes andere `execute` leert `output/result` beim Start, lesen Sie das Ergebnis also, bevor Sie den nächsten Lesevorgang auslösen. - **Mehr:** [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/execute-a-method.html), [Ausführungsstatus](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/execution-status.html), [Text lesen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/reading-text.html) ## Module, Lizenzierung und Support ### Welche Lizenz brauche ich, und wie viele Module deckt sie ab? {#faq-licence} - **Antwort:** Eine Lizenz deckt zehn Module ab; das elfte Modul belegt eine zweite Lizenz desselben Schlüssels, und ein Modul wird mit Status `-11` abgelehnt, wenn keine Lizenz auf dem Gerät es abdeckt. Bezugswege: - Bei HD Vision Systems gekauft: Die Lizenz liegt auf einem LumiScan Key (Windows 11 oder Ubuntu 24.04). Pro Gerät, auf dem die Software gleichzeitig läuft, ist ein LumiScan Key nötig; Keys können zwischen Geräten getauscht werden. - Im ctrlX Store für Windows 11 gekauft: ctrlX WORKS plus ein LumiScan Key. - Im ctrlX Store für ctrlX OS (ctrlX CORE oder IPC) gekauft: eine ctrlX-Lizenz, kein Key. - Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund wird in das Systemprotokoll geschrieben. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/requirements.html#licence), [Modulverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-text-reader-de/1.1.0/lumiscan-text-reader/module-management.html), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ### Wo finde ich weitere Antworten oder Support? {#faq-support} - **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation. Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). - **Mehr:** [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)