Skip to content

read_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedread_ocr_trainf_names_protectedread_ocr_trainf_names_protected🔗

Short description🔗

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

Signature🔗

read_ocr_trainf_names_protected( filename.read TrainingFile, string Password, out string CharacterNames, out integer CharacterCount )void ReadOcrTrainfNamesProtected( const HTuple& TrainingFile, const HTuple& Password, HTuple* CharacterNames, HTuple* CharacterCount )static void HOperatorSet.ReadOcrTrainfNamesProtected( HTuple trainingFile, HTuple password, out HTuple characterNames, out HTuple characterCount )def read_ocr_trainf_names_protected( training_file: MaybeSequence[str], password: MaybeSequence[str] ) -> Tuple[Sequence[str], Sequence[int]]

def read_ocr_trainf_names_protected_s( training_file: MaybeSequence[str], password: MaybeSequence[str] ) -> Tuple[str, int]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 )

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)

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_protectedReadOcrTrainfNamesProtected extracts the names and frequency of all characters in the specified training files. Its functionality corresponds to the functionality of read_ocr_trainf_namesReadOcrTrainfNames, with the addition that read_ocr_trainf_names_protectedReadOcrTrainfNamesProtected can process unprotected and protected training files. Protected training files can be used only with the correct user password Passwordpasswordpassword. If the number of passwords Passwordpasswordpassword equals 1, then every input file TrainingFiletrainingFiletraining_file 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_namesReadOcrTrainfNames. The concept of protecting OCR training data in HALCON is described in protect_ocr_trainfProtectOcrTrainf.

Execution information🔗

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🔗

TrainingFiletrainingFiletraining_file (input_control) filename.read(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Names of the training files.

Default: ''""
File extension: .trf, .otr

Passwordpasswordpassword (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Passwords for protected training files.

CharacterNamescharacterNamescharacter_names (output_control) string(-array) → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Names of the read characters.

CharacterCountcharacterCountcharacter_count (output_control) integer(-array) → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Number of characters.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

protect_ocr_trainfProtectOcrTrainf

See also

read_ocr_trainf_namesReadOcrTrainfNames

Module🔗

OCR/OCV