Available recognition modules of the engine.
Members
Value | Member | Description |
---|---|---|
0 | Auto | The engine will try to automatically select the most suitable recognition module for the zone. This will be determined just before recognition, according to the zone's filling method (OcrZone.FillMethod) and, if necessary, other settings, most typically the character set. |
1 | OmniFontMText | M/TEXT omnifont recognition module. |
2 | OmniFontMor | Multi-lingual MOR omnifont recognition module. |
3 | DotMatrix | DOT 9-pin draft dot-matrix recognition module. |
4 | Omr | OMR (Optical Mark Recognition) module. |
5 | IcrNumeral | Handprinted numeral recognition module. |
6 | IcrCharacter | Handprinted character recognition module. |
7 | MatrixMatching | MAT matrix matching recognition module. |
8 | OmniFontPlus2WayVoting | Omni Font 2-way voting module. |
9 | OmniFontFireWorx | Omni Font FireWorx module. |
10 | OmniFontPlus3WayVoting | Omni Font 3-way voting module. |
11 | Asian | Asian characters recognition module. |
The OcrZoneRecognitionModule contains the different recognition modules of the engine available to you. A recognition module must have been assigned to all zones in their OcrZone.RecognitionModule properties before processing.
Each zone needs to be associated with an OcrZoneRecognitionModule and an OcrZoneFillMethod. This is needed because some recognition modules support more than one fill method, and some fill methods are accepted by more than one recognition module. It is important to ensure that the recognition module/fill method pair is suitable. For example, the multi-lingual MOR omnifont recognition module OcrZoneRecognitionModule.OmniFontMor is capable of recognizing omnifont machine print (OcrZoneFillMethod.OmniFont), 24-pin draft dot-matrix print (OcrZoneFillMethod.DraftDot24), OCR-A (OcrZoneFillMethod.OcrA) and OCR-B (OcrZoneFillMethod.OcrB) texts.
For precise information on permitted recognition module/fill method pairs refer to An Overview of OCR Recognition Modules.
OcrZoneRecognitionModule.Auto can be set in the OcrZone.RecognitionModule property by the user. It can also be generated by the auto-zoning process.
When OcrZoneRecognitionModule.Auto is set, the recognition module is chosen primarily by the fill method (either directly specified, taken as default or auto-detected). The choices will be as follows:
In the first nine cases, only the fill method will be used to determine the recognition module, there will be no checking whether other settings are suitable. With OcrZoneFillMethod.Icr, OcrZoneRecognitionModule.IcrCharacter will be chosen if letters or other characters unsupported by OcrZoneRecognitionModule.IcrNumeral are validated for recognition. The last three will be directed to OcrZoneRecognitionModule.OmniFontMText, unless the engine finds a language, filter or other setting which is not supported by this module. For further details see the An Overview of OCR Recognition Modules.
As an example, the zone's fill method is OcrZoneFillMethod.OmniFont and OcrZoneRecognitionModule.Auto has been specified.
If only the characters of English and/or the main West European languages are validated for recognition, then the M/TEXT omnifont recognition module (OcrZoneRecognitionModule.OmniFontMText) will be automatically selected.
However, if e.g. the Polish characters are also to be recognized, the engine will select the multi-lingual MOR omnifont recognition module OcrZoneRecognitionModule.OmniFontMor, since the M/TEXT recognition module does not support the Polish characters, but the MOR recognition module does.
For an example, refer to DocumentConvertOptions.PagesZones