HALCON Reference Manual 10.0.2

do_ocr_multido_ocr_multido_ocr_multiDoOcrMultiDoOcrMulti (Operator)

Name

do_ocr_multido_ocr_multido_ocr_multiDoOcrMultiDoOcrMulti — Classify characters.

Signature

do_ocr_multi(Character, Image : : OcrHandle : Class, Confidence)

The operator do_ocr_multido_ocr_multido_ocr_multiDoOcrMultiDoOcrMulti assigns a class to every CharacterCharacterCharacterCharactercharacter (character). For gray value features the gray values from the surrounding rectangles of the regions are used. The gray values will be taken from the parameter ImageImageImageImageimage. For each character the corresponding class will be returned in ClassClassClassClassclassVal and a confidence value will be returned in ConfidenceConfidenceConfidenceConfidenceconfidence. The confidence value indicates the similarity between the input pattern and the assigned character.

Parallelization

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

Parameters

CharacterCharacterCharacterCharactercharacter (input_object) region(-array) → object

Characters to be recognized.

ImageImageImageImageimage (input_object) image → object (byte / uint2)

Gray values for the characters.

OcrHandleOcrHandleOcrHandleOcrHandleocrHandle (input_control) ocr_box → (integer)

ID of the OCR classifier.

ClassClassClassClassclassVal (output_control) string(-array) → (string)

Class (name) of the characters.

Number of elements: Class == Character

ConfidenceConfidenceConfidenceConfidenceconfidence (output_control) real(-array) → (real)

Confidence values of the characters.

Number of elements: Confidence == Character

Example (C)

char Class[128];
long orc_handle;
read_ocr("testnet",&orc_handle);
read_image(&Image,"character.tiff");
bin_threshold(Image,&Dark);
connection(Dark,&Character);
count_obj(Character,&num);
open_window(0,0,-1,-1,0,"","",&WindowHandle);
for (i=0; i<num; i++) {
  select_obj(Character,&SingleCharacter,i);
    do_ocr_multi(SingleCharacter,Image,orc_handle,&Class,NULL);
  smallest_rectangle1(SingleCharacter,NULL,&col,&row,);
  set_tposition(row,col);
  write_string(WindowHandle,Class);
}

Result

If the input parameters are correct, the operator do_ocr_singledo_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle returns the value 2 (H_MSG_TRUE). Otherwise an exception will be raised.