find_textfind_textFindTextfind_textFindTextFindText (Operator)

Name

find_textfind_textFindTextfind_textFindTextFindText — Segment text in an image.

Signature

Description

find_textfind_textFindTextfind_textFindTextFindText segments text specified by TextModelTextModelTextModelTextModelTextModeltextModel in ImageImageImageImageImageimage and returns the result in TextResultIDTextResultIDTextResultIDTextResultIDTextResultIDtextResultID. Specific results of TextResultIDTextResultIDTextResultIDTextResultIDTextResultIDtextResultID can be obtained by get_text_resultget_text_resultGetTextResultget_text_resultGetTextResultGetTextResult and get_text_objectget_text_objectGetTextObjectget_text_objectGetTextObjectGetTextObject.

find_textfind_textFindTextfind_textFindTextFindText segments only text which is roughly horizontally aligned in the input image. text_line_orientationtext_line_orientationTextLineOrientationtext_line_orientationTextLineOrientationTextLineOrientation and rotate_imagerotate_imageRotateImagerotate_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_textFindTextfind_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. A text line consists of at least three characters. If TextModelTextModelTextModelTextModelTextModeltextModel contains 'text_line_structure'"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_paramSetTextModelParamset_text_model_paramSetTextModelParamSetTextModelParam.

Since memory is allocated for the text result during the call of find_textfind_textFindTextfind_textFindTextFindText and during the following operations, the text result should be freed explicitly by the operator clear_text_resultclear_text_resultClearTextResultclear_text_resultClearTextResultClearTextResult as soon as it is no longer used.

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_textFindTextfind_textFindTextFindText returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_text_modelcreate_text_modelCreateTextModelcreate_text_modelCreateTextModelCreateTextModel, set_text_model_paramset_text_model_paramSetTextModelParamset_text_model_paramSetTextModelParamSetTextModelParam, text_line_orientationtext_line_orientationTextLineOrientationtext_line_orientationTextLineOrientationTextLineOrientation, text_line_slanttext_line_slantTextLineSlanttext_line_slantTextLineSlantTextLineSlant

Possible Successors

get_text_resultget_text_resultGetTextResultget_text_resultGetTextResultGetTextResult, get_text_objectget_text_objectGetTextObjectget_text_objectGetTextObjectGetTextObject

Module

Foundation