read_ocr_trainfT_read_ocr_trainfReadOcrTrainfread_ocr_trainfReadOcrTrainfReadOcrTrainf (Operator)

Name

read_ocr_trainfT_read_ocr_trainfReadOcrTrainfread_ocr_trainfReadOcrTrainfReadOcrTrainf — Read training characters from files and convert to images.

Signature

read_ocr_trainf( : Characters : TrainingFile : CharacterNames)

read_ocr_trainfread_ocr_trainfReadOcrTrainfread_ocr_trainfReadOcrTrainfReadOcrTrainf reads all characters from the specified file names and converts them into images. The default HALCON file extension for the OCR training file is 'trf'. The domain is defined according to the foreground of the characters (as specified in write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainf). The names of the characters are returned in CharacterNamesCharacterNamesCharacterNamesCharacterNamesCharacterNamescharacterNames. If more than one file name is given the files are processed in the order of the file names.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

CharactersCharactersCharactersCharactersCharacterscharacters (output_object) image-array → object (byte / uint2)

Images read from file.

TrainingFileTrainingFileTrainingFileTrainingFileTrainingFiletrainingFile (input_control) filename.read(-array) → (string)

Names of the training files.

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

File extension: .trf, .otr

CharacterNamesCharacterNamesCharacterNamesCharacterNamesCharacterNamescharacterNames (output_control) string-array → (string)

Names of the read characters.

Result

If the parameter values are correct the operator read_ocr_trainfread_ocr_trainfReadOcrTrainfread_ocr_trainfReadOcrTrainfReadOcrTrainf returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.