do_ocr_multi_class_mlp — Classify multiple characters with an OCR classifier.
do_ocr_multi_class_mlp computes the best class for each of the characters given by the regions 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. In contrast to do_ocr_single_class_mlp, do_ocr_multi_class_mlp can classify multiple characters in one call, and therefore typically is faster than a loop that uses do_ocr_single_class_mlp to classify single characters. However, do_ocr_multi_class_mlp can only return the best class of each character. 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, this is usually not a disadvantage, except in cases where the classes overlap so much that in many cases the second best class must be examined to be able to decide the class of the character. In these cases, do_ocr_single_class_mlp should be used. The result '\x1A' in Class signifies that the respective region has been classified as rejection class.
Before calling do_ocr_multi_class_mlp, the classifier must be trained with trainf_ocr_class_mlp.
Characters to be recognized.
Gray values of the characters.
Handle of the OCR classifier.
Result of classifying the characters with the MLP.
Number of elements: Class == Character
Confidence of the class of the characters.
Number of elements: Confidence == Character
If the parameters are valid, the operator do_ocr_multi_class_mlp returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.