ClassesClasses | | Operators

get_text_objectT_get_text_objectGetTextObjectGetTextObject (Operator)

Name

get_text_objectT_get_text_objectGetTextObjectGetTextObject — Query an iconic value of a text segmentation result.

Signature

get_text_object( : Characters : TextResultID, ResultName : )

Herror T_get_text_object(Hobject* Characters, const Htuple TextResultID, const Htuple ResultName)

void GetTextObject(HObject* Characters, const HTuple& TextResultID, const HTuple& ResultName)

HObject HTextResult::GetTextObject(const HTuple& ResultName) const

HObject HTextResult::GetTextObject(const HString& ResultName) const

HObject HTextResult::GetTextObject(const char* ResultName) const

static void HOperatorSet.GetTextObject(out HObject characters, HTuple textResultID, HTuple resultName)

HObject HTextResult.GetTextObject(HTuple resultName)

HObject HTextResult.GetTextObject(string resultName)

Description

get_text_objectget_text_objectGetTextObjectGetTextObjectGetTextObject queries the iconic result ResultNameResultNameResultNameResultNameresultName of TextResultIDTextResultIDTextResultIDTextResultIDtextResultID returned by find_textfind_textFindTextFindTextFindText. The possible parameter values for ResultNameResultNameResultNameResultNameresultName differ, depending on the text model used within the text segmentation process of find_textfind_textFindTextFindTextFindText.

In the following, first the possible parameter values for text models with ModeModeModeModemode = 'auto'"auto""auto""auto""auto" are listed, and then those for text models with ModeModeModeModemode = 'manual'"manual""manual""manual""manual".

The following results can be queried:

Execution Information

Parameters

CharactersCharactersCharactersCharacterscharacters (output_object)  object(-array) objectHObjectHObjectHobject *

Returned result.

TextResultIDTextResultIDTextResultIDTextResultIDtextResultID (input_control)  text_result HTextResult, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Text result.

ResultNameResultNameResultNameResultNameresultName (input_control)  string(-array) HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Name of the result to be returned.

Default value: 'all_lines' "all_lines" "all_lines" "all_lines" "all_lines"

List of values: 'all_lines'"all_lines""all_lines""all_lines""all_lines", 'element'"element""element""element""element", 'line'"line""line""line""line", 'manual_all_lines'"manual_all_lines""manual_all_lines""manual_all_lines""manual_all_lines", 'manual_compensated_image'"manual_compensated_image""manual_compensated_image""manual_compensated_image""manual_compensated_image", 'manual_line'"manual_line""manual_line""manual_line""manual_line"

Example (HDevelop)

read_image (Image, 'numbers_scale')
create_text_model_reader ('auto', 'Document_Rej.omc', TextModel)
* Optionally specify text properties
set_text_model_param (TextModel, 'min_char_height', 20)
find_text (Image, TextModel, TextResultID)
* Return character regions and corresponding classification results
get_text_object (Characters, TextResultID, 'all_lines')
get_text_result (TextResultID, 'class', Class)

Result

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

Possible Predecessors

find_textfind_textFindTextFindTextFindText

See also

get_text_resultget_text_resultGetTextResultGetTextResultGetTextResult

Module

Foundation


ClassesClasses | | Operators