| Operatoren |
set_text_model_param — Setzen von Parametern eines Textmodells.
set_text_model_param( : : TextModel, GenParamName, GenParamValue : )
set_text_model_param setzt Parameter eines Textmodells. Welche Werte für GenParamName zulässig sind hängt davon ab, welcher Mode bei der Erstellung des Textmodells mittels create_text_model_reader gewählt wurde. Im Folgenden werden zuerst die erlaubten Parameterwerte für Textmodelle mit Mode = 'auto' und anschließend diese für Textmodelle mit Mode = 'manual' beschrieben.
Die Parameter und ihre Werte werden in GenParamName und GenParamValue übergeben werden. Die folgenden Parameter können gesetzt werden:
Parameter für Textmodelle mit Mode = 'auto'
Minimaler Kontrast zwischen Buchstaben und ihrem Hintergrund.
Werteliste: Integer- oder float-Werte zwischen 1 und 255 für Byte-Bilder und zwischen 1 und 65.535 für uint2-Bilder.
Defaultwert: 15
'dark_on_light' wenn der zu segmentierende Text dunkler ist als sein Hintergrund, 'light_on_dark' wenn der zu segmentierende Text heller ist als sein Hintergrund und 'both' falls beide Arten von Text segmentiert werden soll.
Werteliste: 'dark_on_light', 'light_on_dark', 'both'
Defaultwert: 'both'
Minimale Höhe eines Buchstabens in Pixel. Um Buchstaben jeglicher Höhe zu segmentieren, kann der Wert 'auto' übergeben werden. 'min_char_height' schränkt die Höhe von Buchstaben ein, jedoch nicht die Höhe von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
Maximale Höhe eines Buchstabens in Pixel. Um Buchstaben jeglicher Höhe zu segmentieren, kann der Wert 'auto' übergeben werden. 'max_char_height' schränkt die Höhe von Buchstaben ein, jedoch nicht die Höhe von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
Minimale Breite eines Buchstabens in Pixel. Um Buchstaben jeglicher Breite zu segmentieren, kann der Wert 'auto' übergeben werden. 'min_char_width' schränkt die Breite von Buchstaben ein, jedoch nicht die Breite von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
Maximale Breite eines Buchstabens in Pixel. Um Buchstaben jeglicher Breite zu segmentieren, kann der Wert 'auto' übergeben werden. 'max_char_width' schränkt die Breite von Buchstaben ein, jedoch nicht die Breite von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
Minimale Strichbreite eines Buchstabens in Pixel. Soll die minimale Strichbreite während der Textsegmentierung automatisch geschätzt werden, kann der Wert 'auto' übergeben werden. 'min_stroke_width' schränkt die Strichbreite von Buchstaben ein, jedoch nicht die Strichbreite von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
Maximale Strichbreite eines Buchstabens in Pixel. Soll die maximale Strichbreite während der Textsegmentierung automatisch geschätzt werden, kann der Wert 'auto' übergeben werden. 'max_stroke_width' schränkt die Strichbreite von Buchstaben ein, jedoch nicht die Strichbreite von Satz- oder Trennzeichen.
Werteliste: Integer- oder float-Werte größer gleich 1
Defaultwert: 'auto'
'true' wenn Regionen, die den Rand des Definitionsbereichs des Bildes berühren verworfen werden sollen, ansonsten 'false'.
Werteliste: 'true','false'
Defaultwert: 'false'
'true' wenn kleine Satzzeichen, die nahe an der Grundlinie der Textzeile liegen (wie Punkt oder Komma), zu den segmentierten Buchstaben hinzugefügt werden sollen.
Werteliste: 'true','false'
Defaultwert: 'true'
'true' wenn Trennzeichen wie ein Minus oder das Gleichheitszeichen zu den segmentierten Buchstaben hinzugefügt werden sollen.
Werteliste: 'true','false'
Defaultwert: 'true'
'true' wenn Fragmente wie der Punkt auf einem 'i' zu den segmentierten Buchstaben hinzugefügt werden sollen. Das kann allerdings auch dazu führen, dass Störungen zu den segmentierten Buchstaben hinzugefügt werden.
Werteliste: 'true','false'
Defaultwert: 'true'
legt die Struktur des gesuchten Textes fest. Für jede Zeile wird der Abstand zwischen aufeinanderfolgenden Buchstaben berechnet. Ausgehend von diesen Abständen wird die Zeile in einzelne Buchstabenblöcke aufgeteilt. Hierbei werden sehr kleine Zeichen wie z.B. '.', '_' und '-' vernachlässigt und als Leerzeichen interpretiert. Darüber hinaus können zusätzliche Trennzeichen angegeben werde, die ebenfalls vernachlässigt werden sollen, siehe 'text_line_separators'. Für die entstandenen Buchstabenblöcke wird dann geprüft ob sie einer der übergebenen Strukturen entsprechen.
Eine Struktur besteht aus einem String, der die Anzahl der Buchstaben/Ziffern pro Buchstabenblock enthält, welche durch Leerzeichen getrennt sind. Soll zum Beispiel ein Datum mit jeweils zwei Ziffern für Tag, Monat und Jahr gefunden werden, wäre die Struktur '2 2 2'. Kann das Jahr auch aus vier Ziffern bestehen, wäre die Struktur '2 2 2-4', so dass der letzte Block aus zwei bis vier Buchstaben/Ziffern bestehen kann. Es ist möglich mehr als eine Struktur zu setzen, indem ein Index an den Parameter angehängt wird, z.B. 'text_line_structure_0', 'text_line_structure_1'. Wenn 'text_line_structure' auf einen leeren String ' ' gesetzt ist, kann der zu findende Texte aus jeder beliebigen Struktur bestehen.
Jede gefundene Struktur wird als einzelne Zeile gespeichert. Folglich bezieht sich dann 'line' in get_text_object auf die gefundenen Strukturen. Soll stattdessen die komplette Zeile zurückgeliefert werden, die eine Struktur enthält, kann 'return_whole_line' auf 'true' gesetzt werden.
Defaultwert: ' '
String von Trennzeichen, die bei der Suche nach Strukturen vernachlässigt werden sollen, siehe 'text_line_structure'. Hierbei ist zu beachten, dass ein solches Trennzeichen immer auch im Klassifikator enthalten sein muss. Sollen z.B. die Zeichen ':' und '\' als Trennzeichen behandelt werden, kann der String ':\\' übergeben werden. Hierbei ist zu beachten, dass das vorrangeführte '\' die Verwendung des Symbols '\' als Literal ermöglicht.
Werteliste: '/',':', ':\\' , '\\/:' ,...
Defaultwert: ' '
'true' falls nur die gefundenen Strukturen als Zeilen zurückgegeben werden sollen, 'false' falls jede Zeile, die eine passende Stuktur enthält komplett zurückgegeben werden soll.
Werteliste: 'true','false'
Defaultwert: 'false'
MLP-basierter OCR Klassifikator. Ein initialer Klassifikator wird bereits bei der Erstellung des Textmodells gesetzt. Siehe create_text_model_reader für weitere Informationen.
Parameter für Textmodelle mit Mode = 'manual'
Höhe eines Buchstabens in Pixel. Dieser Wert bezieht sich auf einen Großbuchstaben. Standardwert: 30px
Breite eines Buchstabens in Pixel. Dieser Wert bezieht sich auf einen Großbuchstaben. Standardwert: 20px
Strichbreite eines Buchstabens in Pixel. Standardwert: 4.0px
Maximale Abweichung der Buchstaben von der Grundlinie einer Zeile in Prozent der Buchstabenhöhe. Standardwert: 0.15
'dark_on_light' wenn der zu segmentierende Text dunkler ist als sein Hintergrund, ansonsten 'light_on_dark'. Standardwert: 'dark_on_light'
'true' wenn der zu segmentierende Text nur Großbuchstaben oder Zahlen enthält, ansonsten 'false'. Standardwert: 'false'
'true' wenn der zu segmentierende Text ein Punktdruck ist, ansonsten 'false'. Standardwert: 'false'
'true' wenn der zu segmentierende Text sehr viele lokale Änderungen der Polarität aufgrund von Reflektionen enthält, ansonsten 'false'. Standardwert: 'false'
'true' wenn sich Linien in der Nähe des zu segmentierenden Textes befinden, ansonsten 'false'. Standardwert: 'false'
'true' wenn Regionen, die den Rand der Bilddomäne berühren verworfen werden sollen, ansonsten 'false'. Standardwert: 'false'
Maximale Anzahl zu findender Zeilen. Null oder ein negativer Wert impliziert keine Begrenzung. Wird 'max_line_num' auf einen kleinen Wert gesetzt, kann dies einen positiven Einfluss auf die Laufzeit von find_text haben. Standardwert: ohne Begrenzung
'true' wenn Interpunktionszeichen (wie Punkt oder Komma) zu den segmentierten Buchstaben hinzugefügt werden sollen. Standardwert: 'true'
'true' wenn Trennzeichen wie ein Minus oder das Gleichheitszeichen zu den segmentierten Buchstaben hinzugefügt werden sollen. Standardwert: 'true'
'true' wenn Fragmente wie der Punkt auf einem 'i' zu den segmentierten Buchstaben hinzugefügt werden sollen. Das kann auch dazu führen, dass Störungen zu den segmentierten Buchstaben hinzugefügt werden. Standardwert: 'true'
minimale Größe von Fragmenten die hinzugefügt werden, sofern 'add_fragments' auf 'true' gesetzt ist. Standardwert: 1
legt die Struktur des zu findenden Textes fest um den Suchraum zu verkleinern und falsche Treffer zu vermeiden. Die Struktur besteht aus einem String, der die Anzahl der Buchstaben/Ziffern pro Buchstabenblock enthält, welche durch Leerzeichen getrennt sind. Soll zum Beispiel ein Datum mit jeweils zwei Ziffern für Tag, Monat und Jahr gefunden werden, wäre die Struktur '2 2 2'. Kann das Jahr auch aus vier Ziffern bestehen, wäre die Struktur '2 2 2-4', so dass der letzte Block aus zwei bis vier Buchstaben/Ziffern bestehen kann. Es ist möglich mehr als eine Struktur zu setzen, indem ein Index an den Parameter angehängt wird, z.B. 'text_line_structure_0', 'text_line_structure_1'. Wenn 'text_line_structure' auf einen leeren String ' ' gesetzt ist, kann der zu findende Texte aus jeder beliebigen Struktur bestehen.
'true' wenn ausgewählte Zwischenergebnisse in der Ausgabe von find_text vorgehalten werden sollen, damit sie später mittels get_text_result oder get_text_object abgefragt werden können.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.Textmodell.
Zu setzende Parameter.
Defaultwert: 'min_contrast'
Werteliste: 'add_fragments', 'base_line_tolerance', 'char_height', 'char_width', 'eliminate_border_blobs', 'eliminate_horizontal_lines', 'fragment_size_min', 'is_dotprint', 'is_imprinted', 'max_char_height', 'max_char_width', 'max_line_num', 'max_stroke_width', 'min_char_height', 'min_char_width', 'min_contrast', 'min_stroke_width', 'mlp_classifier', 'persistence', 'polarity', 'return_punctuation', 'return_separators', 'return_whole_line', 'stroke_width', 'text_line_separators', 'text_line_structure', 'text_line_structure_0', 'text_line_structure_1', 'text_line_structure_2', 'uppercase_only'
Werte der Parameter.
Defaultwert: 10
Werteliste: 'auto', 'both', 'dark_on_light', 'false', 'light_on_dark', 'true'
Sind alle Eingabeparameter korrekt, gibt set_text_model_param den Wert 2 (H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt.
OCR/OCV
| Operatoren |