Ausführungsstatus

Jede Operation meldet ihren Ausgang auf zwei Knoten neben sich: output/status-code für Ihr Programm und output/status-text für einen Menschen. Diese Codes sind der Ausführungsstatus der Finder, nicht der Modulstatus von Cam Driver, AI Object Matching oder Calibration; siehe Ausführungsstatus der Finder.

Statuscodes

Code Bedeutung Wann er auftritt

Code	Bedeutung	Wann er auftritt
`0`	Leerlauf	Die Operation ist seit dem Start der Anwendung nicht gelaufen
`1`	OK	Die Operation wurde abgeschlossen. Ein Lesevorgang kann trotzdem keine Wörter gefunden haben - das ist ein normales Ergebnis, kein Fehler
`-1`	Belegt	Eine andere Operation desselben Moduls lief noch. Es wurde nichts getan; versuchen Sie es erneut, wenn sie abgeschlossen ist
`-2`	Ungültige Eingabe	Ein Eingabewert kann nicht verwendet werden - ein erforderlicher Knoten ist leer, ein unbekanntes `input/engine`, `input/layout`, `input/preprocess` oder `input/characters/mode`, ein leerer Zeichensatz, eine Sprache ohne installiertes Modell, ein Ausschnitt, der nicht in das Bild passt, oder eine Bildadresse, die auf diese Anwendung selbst zeigt
`-3`	Bild lesen fehlgeschlagen	Der Bildknoten an der angegebenen Adresse fehlt, ist leer, inkonsistent oder verwendet ein nicht unterstütztes Pixelformat. Prüfen Sie, ob die Kameraanwendung läuft und ein Bild aufgenommen hat
`-4`	Quelle nicht gefunden	Eine erforderliche Datei oder ein Verzeichnis fehlt oder ist nicht lesbar - bei `system/set-tessdata-dir` ein Pfad, der kein Verzeichnis ist
`-5`	Ungültige Ausschnittsregion	Die Region of Interest passt nicht in das Bild. `read-text` meldet einen Ausschnitt, der nicht passt, als `-2`, siehe Text lesen
`-6`	Schreiben fehlgeschlagen	Eine Datei konnte nicht geschrieben werden - meist ein Berechtigungsproblem oder ein voller Datenträger
`-7`	Algorithmus fehlgeschlagen	Die OCR-Engine konnte nicht starten oder ein Sprachmodell konnte nicht geladen werden - zum Beispiel ein Modell, dessen Upload noch läuft
`-8`	Veröffentlichen fehlgeschlagen	Das Ergebnis konnte nicht auf den Data Layer zurückgeschrieben werden
`-9`	Modul nicht gefunden	Das genannte Modul existiert nicht. Prüfen Sie `system/modules` für die aktuelle Liste
`-10`	Modul existiert bereits	Ein Modul mit diesem Namen ist bereits vorhanden
`-11`	Lizenz nicht verfügbar	Keine Lizenz deckt das Modul ab. Siehe Modulverwaltung

0

Leerlauf

Die Operation ist seit dem Start der Anwendung nicht gelaufen

1

Die Operation wurde abgeschlossen. Ein Lesevorgang kann trotzdem keine Wörter gefunden haben - das ist ein normales Ergebnis, kein Fehler

-1

Belegt

Eine andere Operation desselben Moduls lief noch. Es wurde nichts getan; versuchen Sie es erneut, wenn sie abgeschlossen ist

-2

Ungültige Eingabe

Ein Eingabewert kann nicht verwendet werden - ein erforderlicher Knoten ist leer, ein unbekanntes input/engine, input/layout, input/preprocess oder input/characters/mode, ein leerer Zeichensatz, eine Sprache ohne installiertes Modell, ein Ausschnitt, der nicht in das Bild passt, oder eine Bildadresse, die auf diese Anwendung selbst zeigt

-3

Bild lesen fehlgeschlagen

Der Bildknoten an der angegebenen Adresse fehlt, ist leer, inkonsistent oder verwendet ein nicht unterstütztes Pixelformat. Prüfen Sie, ob die Kameraanwendung läuft und ein Bild aufgenommen hat

-4

Quelle nicht gefunden

Eine erforderliche Datei oder ein Verzeichnis fehlt oder ist nicht lesbar - bei system/set-tessdata-dir ein Pfad, der kein Verzeichnis ist

-5

Ungültige Ausschnittsregion

Die Region of Interest passt nicht in das Bild. read-text meldet einen Ausschnitt, der nicht passt, als -2, siehe Text lesen

-6

Schreiben fehlgeschlagen

Eine Datei konnte nicht geschrieben werden - meist ein Berechtigungsproblem oder ein voller Datenträger

-7

Algorithmus fehlgeschlagen

Die OCR-Engine konnte nicht starten oder ein Sprachmodell konnte nicht geladen werden - zum Beispiel ein Modell, dessen Upload noch läuft

-8

Veröffentlichen fehlgeschlagen

Das Ergebnis konnte nicht auf den Data Layer zurückgeschrieben werden

-9

Modul nicht gefunden

Das genannte Modul existiert nicht. Prüfen Sie system/modules für die aktuelle Liste

-10

Modul existiert bereits

Ein Modul mit diesem Namen ist bereits vorhanden

-11

Lizenz nicht verfügbar

Keine Lizenz deckt das Modul ab. Siehe Modulverwaltung

Diese Zahlen sind Teil der Schnittstelle der Anwendung. In späteren Releases können neue Codes hinzukommen, aber bestehende ändern nie ihre Bedeutung; Logik, die auf ihnen aufbaut, funktioniert nach einem Update weiter.

Deshalb ist auch die Prüfung des Vorzeichens der robustere Test: status-code < 0 bleibt korrekt, selbst wenn ein Release einen Fehler einführt, den Ihr Programm noch nie gesehen hat.

Welche Operation welche Codes meldet

Operation Mögliche Codes

Operation	Mögliche Codes
`read-text`	`1`, `-1`, `-2`, `-3`, `-7`
`system/set-tessdata-dir`	`1`, `-2`, `-4`, `-6`
`system/save-module-inputs`	`1`, `-6`, `-9`

read-text

1, -1, -2, -3, -7

system/set-tessdata-dir

1, -2, -4, -6

system/save-module-inputs

1, -6, -9

Statustext

output/status-text beginnt immer mit ok: oder error: und nennt den Grund in Worten. Er wird zur selben Zeit wie der Statuscode geschrieben, sodass beide immer übereinstimmen.

Jede Operation hat ihr eigenes Knotenpaar, und die Knoten behalten ihre Werte, bis diese Operation erneut läuft. Ein fehlgeschlagenes set-tessdata-dir stört also nicht das Ergebnis des letzten Lesevorgangs.