HALCON 17.12 / HALCON Operator Reference / OCR / Training Files
ClassesClasses | | Operators

read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtected (Operator)

Name

read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtected — Query which characters are stored in a (protected) training file.

Signature

read_ocr_trainf_names_protected( : : TrainingFile, Password : CharacterNames, CharacterCount)

Herror read_ocr_trainf_names_protected(const char* TrainingFile, const char* Password, char* CharacterNames, Hlong* CharacterCount)

Herror T_read_ocr_trainf_names_protected(const Htuple TrainingFile, const Htuple Password, Htuple* CharacterNames, Htuple* CharacterCount)

void ReadOcrTrainfNamesProtected(const HTuple& TrainingFile, const HTuple& Password, HTuple* CharacterNames, HTuple* CharacterCount)

static HTuple HMisc::ReadOcrTrainfNamesProtected(const HTuple& TrainingFile, const HTuple& Password, HTuple* CharacterCount)

static HString HMisc::ReadOcrTrainfNamesProtected(const HString& TrainingFile, const HString& Password, Hlong* CharacterCount)

static HString HMisc::ReadOcrTrainfNamesProtected(const char* TrainingFile, const char* Password, Hlong* CharacterCount)

static void HOperatorSet.ReadOcrTrainfNamesProtected(HTuple trainingFile, HTuple password, out HTuple characterNames, out HTuple characterCount)

static HTuple HMisc.ReadOcrTrainfNamesProtected(HTuple trainingFile, HTuple password, out HTuple characterCount)

static string HMisc.ReadOcrTrainfNamesProtected(string trainingFile, string password, out int characterCount)

Description

read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtected extracts the names and frequency of all characters in the specified training files. Its functionality corresponds to the functionality of read_ocr_trainf_namesread_ocr_trainf_namesReadOcrTrainfNamesReadOcrTrainfNamesReadOcrTrainfNames, with the addition that read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtected can process unprotected and protected training files. Protected training files can be used only with the correct user password PasswordPasswordPasswordPasswordpassword. If the number of passwords PasswordPasswordPasswordPasswordpassword equals 1, then every input file TrainingFileTrainingFileTrainingFileTrainingFiletrainingFile is checked with that password, otherwise the number of passwords has to be equal to the number of input files and the input file at position n is checked with the password at position n. For unprotected training files the passwords are ignored.

For a more detailed description of the operator's functionality see read_ocr_trainf_namesread_ocr_trainf_namesReadOcrTrainfNamesReadOcrTrainfNamesReadOcrTrainfNames. The concept of protecting OCR training data in HALCON is described in protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfProtectOcrTrainf.

Execution Information

Parameters

TrainingFileTrainingFileTrainingFileTrainingFiletrainingFile (input_control)  filename.read(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)

Names of the training files.

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

File extension: .trf, .otr

PasswordPasswordPasswordPasswordpassword (input_control)  string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)

Passwords for protected training files.

CharacterNamesCharacterNamesCharacterNamesCharacterNamescharacterNames (output_control)  string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)

Names of the read characters.

CharacterCountCharacterCountCharacterCountCharacterCountcharacterCount (output_control)  integer(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of characters.

Result

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

Possible Predecessors

protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfProtectOcrTrainf

See also

read_ocr_trainf_namesread_ocr_trainf_namesReadOcrTrainfNamesReadOcrTrainfNamesReadOcrTrainfNames

Module

OCR/OCV

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH