HALCON Reference Manual 10.0.2

do_ocr_singleT_do_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle (Operator)

Name

do_ocr_singleT_do_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle — Classify one character.

Signature

do_ocr_single(Character, Image : : OcrHandle : Classes, Confidences)

The operator do_ocr_singledo_ocr_singledo_ocr_singleDoOcrSingleDoOcrSingle assigns classes to the CharacterCharacterCharacterCharactercharacter (characters). For gray value features gray values of the surrounding rectangles of the regions will be used. The gray values will be taken from the parameter ImageImageImageImageimage. For each character the two classes with the highest confidencenses will be returned in ClassesClassesClassesClassesclasses. The corresponding confidences will be returned in ConfidencesConfidencesConfidencesConfidencesconfidences. 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).
Processed without parallelization.

Parameters

CharacterCharacterCharacterCharactercharacter (input_object) region → object

Character to be recognized.

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

Gray values of the characters.

OcrHandleOcrHandleOcrHandleOcrHandleocrHandle (input_control) ocr_box → (integer)

ID of the OCR classifier.

ClassesClassesClassesClassesclasses (output_control) string-array → (string)

Classes (names) of the characters.

Number of elements: 2

ConfidencesConfidencesConfidencesConfidencesconfidences (output_control) real-array → (real)

Confidence values of the characters.

Number of elements: 2

Example (C)

HTuple  Classes,Confidences;
long    orc_handle;
HTuple  OcrHandle;

read_ocr("testnet",&orc_handle);
create_tuple(&OcrHandle,1);
set_i(OcrHandle,orc_handle,0);
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);
  T_do_ocr_single(SingleCharacter,Image,
                  OcrHandle,&Classes,&Confidences);
  printf("best   = %s (%g)\n",
         get_s(Classes,0),get_d(Confidences,0));
  printf("second = %s (%g)\n\n",
         get_s(Classes,1),get_d(Confidences,1));
}

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.