do_ocr_single_class_mlp — Classify a single character with an OCR classifier.
do_ocr_single_class_mlp computes the best Num classes of the character given by the region Character and the gray values Image with the OCR classifier OCRHandle and returns the classes in Class and the corresponding confidences (probabilities) of the classes in Confidence. Because multiple classes may be returned by do_ocr_single_class_mlp, Character may only contain a single region (a single character). If multiple characters should be classified in a single call, do_ocr_multi_class_mlp must be used. Because do_ocr_multi_class_mlp typically is faster than a loop with do_ocr_single_class_mlp and because the confidences can be interpreted as probabilities (see classify_class_mlp and evaluate_class_mlp), and it is therefore easy to check whether a character has been classified with too much uncertainty, in most cases do_ocr_multi_class_mlp should be used, unless the second-best class should be examined explicitly. The result '\x1A' in Class signifies that the region has been classified as rejection class.
Before calling do_ocr_single_class_mlp, the classifier must be trained with trainf_ocr_class_mlp.
Character to be recognized.
Gray values of the character.
Handle of the OCR classifier.
Number of best classes to determine.
Default value: 1
Suggested values: 1, 2, 3, 4, 5
Result of classifying the character with the MLP.
Confidence(s) of the class(es) of the character.
If the parameters are valid, the operator do_ocr_single_class_mlp returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.