| Operators |
set_text_model_param — Set parameters of a text model.
set_text_model_param( : : TextModel, GenParamName, GenParamValue : )
set_text_model_param sets parameters of a text model. The list of allowed parameter values for GenParamName differs, depending on which Mode was set when creating the text model with create_text_model_reader. In the following, first the parameter values for text models with Mode = 'auto' are listed, and then those for text models with Mode = 'manual'.
The name and value of a parameter must be given in GenParamName and GenParamValue. The following values are possible:
Parameters of text models with Mode = 'auto'
The minimal contrast the characters have to their surrounding background.
List of values: integer or float value between 1 and 255 for byte images and between 1 and 65.535 for uint2 images
Default value: 15
'dark_on_light' if the text to be segmented is darker than its background, 'light_on_dark' if the text to be segmented is lighter than its background, and 'both' if both kinds of text are to be segmented.
List of values: 'dark_on_light', 'light_on_dark', 'both'
Default value: 'both'
The minimal height of the characters in pixel. If text of arbitrary height is to be segmented, 'auto' may be passed. Note that 'min_char_height' refers to characters only. The height of punctuation marks or separators is not restricted by 'min_char_height'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
The maximal height of the characters in pixel. If text of arbitrary height is to be segmented, 'auto' may be passed. Note that 'max_char_height' refers to characters only. The height of punctuation marks or separators is not restricted by 'max_char_height'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
The minimal width of the characters in pixel. If text of arbitrary width is to be segmented, 'auto' may be passed. Note that 'min_char_width' refers to characters only. The width of punctuation marks or separators is not restricted by 'min_char_width'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
The maximal width of the characters in pixel. If text of arbitrary width is to be segmented, 'auto' may be passed. Note that 'max_char_width' refers to characters only. The width of punctuation marks or separators is not restricted by 'max_char_width'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
The minimal stroke width of the characters in pixel. If the minimal stroke width is to be estimated within the text segmentation process automatically, 'auto' may be passed. Note that 'min_stroke_width' refers to characters only. The stroke width of punctuation marks or separators is not restricted by 'min_stroke_width'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
The maximal stroke width of the characters in pixel. If the maximal stroke width is to be estimated within the text segmentation process automatically, 'auto' may be passed. Note that 'max_stroke_width' refers to characters only. The stroke width of punctuation marks or separators is not restricted by 'max_stroke_width'.
List of values: integer or float value greater or equal to 1
Default value: 'auto'
'true' if regions that are touching the border of the image domain should be discarded, otherwise 'false'.
List of values: 'true','false'
Default value: 'false'
'true' if small punctuation marks that lie close to the base line of the corresponding text line (e.g. dots or commas) are to be returned. 'false' if no such punctuations should be returned.
List of values: 'true','false'
Default value: 'true'
'true' if separators such as a minus or the equality sign should be returned as well. 'false' if no separators should be returned.
List of values: 'true','false'
Default value: 'true'
'true' if fragments, such as the dot on the 'i', should be added to the segmented characters, otherwise 'false'. Be aware, that this can cause noise to be added to the segmented characters.
List of values: 'true','false'
Default value: 'true'
To simplify the search for specific structures (e.g. dates or serial numbers) within the segmented text, it is possible to define text line structures. For each text line the distances between the characters are calculated, and based on these distances, the text line is divided into text blocks. Short characters such as '.', '_' and '-' are ignored in this process and treated as spaces. Furthermore, it is possible to define user specific separators which are also ignored. See the description of 'text_line_separators' for details. It is then tested if any of the user defined text line structures fit the resulting text blocks.
For example, if the text to be found is a date with two characters for month, day, and year the structure would be '2 2 2'. If the year may consist of two or four characters, the structure would be '2 2 2-4', indicating that the last character block consists of two to four characters. It is possible to provide more than one structure to match by appending an index to the parameter name, e.g. 'text_line_structure_0', 'text_line_structure_1'. If 'text_line_structure' is set to an empty string ' ', the text to be found may have any structure.
Please observe, that every text line structure which is found, is saved as a unique text line within the text result. Hence, when calling get_text_object, a 'line' then refers to a valid text line structure. If the whole text line containing the text line structure is to be returned instead, it is possible to set 'return_whole_line' accordingly.
Default value: ' '
A string containing the list of characters which are to be ignored in the process of finding text line structures, see 'text_line_structure' for further details. Please note, user specific separators need to be valid characters within the used OCR classifier. For example, if ':' and '\' are to be ignored, ':\\' should be passed. Please observe, that '\' escapes any special symbol to treat it as a literal, and hence '\\' needs to be passed to use '\' as a separator.
List of values: '/',':', ':\\' , '\\/:' ,...
Default value: ' '
'false' if only the segmented text line structures are to be returned as text lines. 'true' if each whole text line containing a text line structure is to be returned in text lines.
List of values: 'true','false'
Default value: 'false'
The MLP-based OCR classifier used within find_text for text segmentation. An initial classifier is set when the text model is created. See create_text_model_reader for more information about the required OCR Classifier.
Parameters of text models with Mode = 'manual'
Height of the characters in pixel. Refers to an uppercase character. Default value: 30px
Width of the characters in pixel. Refers to an uppercase character. Default value: 20px
Stroke width of the characters in pixel. Default value: 4.0px
Maximum base line deviation of the characters (in percent of 'char_height'). Default value: 0.15
'dark_on_light' if the text to be segmented is darker than its background, otherwise 'light_on_dark'. Default value: 'dark_on_light'
'true' if the text to be segmented contains uppercase characters or numbers only, otherwise 'false'. Default value: 'false'
'true' if the text to be segmented is a dotprint, otherwise 'false'. Default value: 'false'
'true' if the text to be segmented suffers of local changes of polarity due to reflections, otherwise 'false'. Default value: 'false'
'true' if there are longer horizontal structures close to the text to be segmented, otherwise 'false'. Default value: 'false'
'true' if regions that are touching the border of the image domain should be discarded, otherwise 'false'. Default value: 'false'
Maximum number of lines to be found. Zero or negative values indicate no limitation. Setting 'max_line_num' to a low value may strongly improve the runtime of find_text. Default value: no limitation
'true' if punctuation marks (e.g., dots or comma) should be added to the segmented characters. Default value: 'true'
'true' if separators such as a minus or the equality sign should be added to the segmented characters. Default value: 'true'
'true' if fragments, such as the dot on the 'i', should be added to the segmented characters. Be aware, that this can cause noise to be added to the segmented characters. Default value: 'true'
minimum area of fragment regions that are added if 'add_fragments' is set to 'true'. Default value: 1
specifies the structure of the text to be found to reduce the search space and to avoid false positives. The structure is a string that contains the number of characters for every character block and spaces between these character blocks. For example, if the text to be found is a date with two characters for month, day, and year the structure would be '2 2 2'. If the year may also consist of four characters the structure would be '2 2 2-4', indicating that the last character block consists of two to four characters. It is possible to provide more than one structure to match by appending an index to the parameter name, e.g. 'text_line_structure_0', 'text_line_structure_1'. If 'text_line_structure' is set to an empty string ' ', the text to be found may have any structure. Default value: ' '
'true' if selected intermediate results should be kept with the output result of find_text.
This operator modifies the state of the following input parameter:
The value of this parameter may not be shared across multiple threads without external synchronization.Text model.
Names of the parameters to be set.
Default value: 'min_contrast'
List of values: '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'
Values of the parameters to be set.
Default value: 10
List of values: 'auto', 'both', 'dark_on_light', 'false', 'light_on_dark', 'true'
If the input parameters are set correctly, the operator set_text_model_param returns the value 2 (H_MSG_TRUE). Otherwise, an exception will be raised.
OCR/OCV
| Operators |