find_textfind_textfind_textFindTextFindText (Operator)

Name

find_textfind_textfind_textFindTextFindText — Segment text in an image.

Signature

Description

find_textfind_textfind_textFindTextFindText segments text specified by TextModelTextModelTextModelTextModeltextModel in ImageImageImageImageimage and returns the result in TextResultIDTextResultIDTextResultIDTextResultIDtextResultID. Specific results of TextResultIDTextResultIDTextResultIDTextResultIDtextResultID can be obtained by get_text_resultget_text_resultget_text_resultGetTextResultGetTextResult and get_text_objectget_text_objectget_text_objectGetTextObjectGetTextObject.

find_textfind_textfind_textFindTextFindText segments only text which is roughly horizontally aligned in the input image. text_line_orientationtext_line_orientationtext_line_orientationTextLineOrientationTextLineOrientation and rotate_imagerotate_imagerotate_imageRotateImageRotateImage can be used to achieve this alignment.

The input image is preprocessed such that character like structures are enhanced. On this image find_textfind_textfind_textFindTextFindText applies several thresholds and selects character candidates based on region and gray value features. These candidates are further clustered to lines. Each line is individually completed and tested if it fulfills the constraints of a text line. If TextModelTextModelTextModelTextModeltextModel contains 'text_line_structure'"text_line_structure""text_line_structure""text_line_structure""text_line_structure" entries, the completed line is fitted to these structures. Finally interpunctations and separators are added if the correspondent parameters were set via set_text_model_paramset_text_model_paramset_text_model_paramSetTextModelParamSetTextModelParam.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on internal data level.

Parameters

Result

If the parameters are valid, the operator find_textfind_textfind_textFindTextFindText returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_text_modelcreate_text_modelcreate_text_modelCreateTextModelCreateTextModel, set_text_model_paramset_text_model_paramset_text_model_paramSetTextModelParamSetTextModelParam, text_line_orientationtext_line_orientationtext_line_orientationTextLineOrientationTextLineOrientation, text_line_slanttext_line_slanttext_line_slantTextLineSlantTextLineSlant

Possible Successors

get_text_resultget_text_resultget_text_resultGetTextResultGetTextResult, get_text_objectget_text_objectget_text_objectGetTextObjectGetTextObject

Module

Foundation