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
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 HString HMisc::ReadOcrTrainfNamesProtected(const wchar_t* TrainingFile, const wchar_t* Password, Hlong* CharacterCount)
(Windows only)
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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