ocr_change_char [HALCON Operator Reference / Version 17.12]

ocr_change_charT_ocr_change_charOcrChangeCharOcrChangeChar — Define a new conversion table for the characters.

Warning

ocr_change_charocr_change_charOcrChangeCharOcrChangeCharOcrChangeChar is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM or CNN based operators instead.

Signature

Herror T_ocr_change_char(const Htuple OcrHandle, const Htuple Character)

void OcrChangeChar(const HTuple& OcrHandle, const HTuple& Character)

void HOCRBox::OcrChangeChar(const HTuple& Character) const

Description

The operator ocr_change_charocr_change_charOcrChangeCharOcrChangeCharOcrChangeChar establishes a new look-up table for the characters. Hereby the number of strings of CharacterCharacterCharacterCharactercharacter must be the same as of the classifier OcrHandleOcrHandleOcrHandleOcrHandleocrHandle. In order to enlarge the font, the operator ocr_change_charocr_change_charOcrChangeCharOcrChangeCharOcrChangeChar may be used as follows: More characters than actually needed will be indicated when creating a network using (create_ocr_class_boxcreate_ocr_class_boxCreateOcrClassBoxCreateOcrClassBoxCreateOcrClassBox). The last n characters will not be used so far. If more characters are needed at a later stage, these unused characters will be allocated and then trained with the help of the operator ocr_change_charocr_change_charOcrChangeCharOcrChangeCharOcrChangeChar.

Execution Information

Parameters

OcrHandleOcrHandleOcrHandleOcrHandleocrHandle (input_control, state is modified) ocr_box → (integer)

ID of the OCR-network to be changed.

CharacterCharacterCharacterCharactercharacter (input_control) string-array → (string)

New assign of characters.

Default value: ['a','b','c'] ["a","b","c"] ["a","b","c"] ["a","b","c"] ["a","b","c"]

Example (C)

HTuple  Character1, Character2, OcrHandle;
create_tuple(&Character1,26);
set_s(Character1,"a",0);
set_s(Character1,"b",1);
/* set parameter values */
T_create_ocr_net(WidthPattern,HeightPattern,Interpolation,
                 Features,HiddenLayer,Init,Character1,&OcrHandle);
/* later... */
create_tuple(&Character2,26);
set_s(Character2,"alpha",0);
set_s(Character2,"beta",1);
T_ocr_change_char(OcrHandle,Character2);

Result

If the number of characters in CharacterCharacterCharacterCharactercharacter is identical with the number of the characters of the network, the operator ocr_change_charocr_change_charOcrChangeCharOcrChangeCharOcrChangeChar returns the value 2 (H_MSG_TRUE). Otherwise an exception will be raised.

ocr_change_charT_ocr_change_charOcrChangeCharOcrChangeChar (Operator)

Name