read_ocr_trainf_names_protected — Query which characters are stored in a (protected) training file.
read_ocr_trainf_names_protected extracts the names and frequency of all characters in the specified training files. Its functionality corresponds to the functionality of read_ocr_trainf_names, with the addition that read_ocr_trainf_names_protected can process unprotected and protected training files. Protected training files can be used only with the correct user password Password. If the number of passwords Password equals 1, then every input file TrainingFile 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_names. The concept of protecting OCR training data in HALCON is described in protect_ocr_trainf.
Names of the training files.
Default value: ''
File extension: .trf, .otr
Passwords for protected training files.
Names of the read characters.
Number of characters.
If the parameter values are correct the operator read_ocr_trainf_names_protected returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.