NativeOcrZoneRecognitionModule Enumeration

Summary

Available recognition modules of the engine.

Syntax

C++/CLI

Java

Python

[SerializableAttribute()] 
public enum NativeOcrZoneRecognitionModule

public enum NativeOcrZoneRecognitionModule

[SerializableAttribute()] 
public enum class NativeOcrZoneRecognitionModule

class NativeOcrZoneRecognitionModule(Enum): 
   Auto = 0 
   OmniFontMText = 1 
   OmniFontMor = 2 
   DotMatrix = 3 
   Omr = 4 
   IcrNumeral = 5 
   IcrCharacter = 6 
   MatrixMatching = 7 
   OmniFontPlus2WayVoting = 8 
   OmniFontFireWorx = 9 
   OmniFontPlus3WayVoting = 10 
   Asian = 11

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 (NativeOcrZone.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	Hand-printed numeral recognition module.
6	IcrCharacter	Hand-printed 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.

Remarks

Used with engine-specific zones. For more information, refer to IOcrZoneManager.GetNativeZone and IOcrZoneManager.SetNativeZone.

The NativeOcrZoneRecognitionModule contains the different recognition modules of the engine available to you. A recognition module must have been assigned to all zones in their NativeOcrZone.RecognitionModule properties before processing.

Not all recognition modules are available to all engines. To determine which recognition modules are available use IOcrZoneManager.GetSupportedNativeRecognitionModules. Trying to set a recognition module that is not available to the engine will cause an error.

Each zone needs to be associated with a NativeOcrZoneRecognitionModule and a NativeOcrZoneFillMethod. 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 NativeOcrZoneRecognitionModule.OmniFontMor is capable of recognizing omnifont machine print (NativeOcrZoneFillMethod.OmniFont), 24-pin draft dot-matrix print (NativeOcrZoneFillMethod.DraftDot24), OCR-A (NativeOcrZoneFillMethod.OcrA) and OCR-B (NativeOcrZoneFillMethod.OcrB) texts.

NativeOcrZoneRecognitionModule.Auto can be set in the NativeOcrZone.RecognitionModule property by the user. It will also be generated by IOcrPage.AutoZone (auto-zoning) and will, under certain circumstances, be generated by the IOcrPage.UpdateNativeFillMethod method.

Force the use of a particular recognition module by specifying it directly in the zone's NativeOcrZone.RecognitionModule property after calling IOcrPage.AutoZone or IOcrPage.UpdateNativeFillMethod.

When NativeOcrZoneRecognitionModule.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:

Fill Method	Recognition Module
NativeOcrZoneFillMethod.DotDigitt	NativeOcrZoneRecognitionModule.MatrixMatching
NativeOcrZoneFillMethod.DashDigit	NativeOcrZoneRecognitionModule.MatrixMatching
NativeOcrZoneFillMethod.Mice	NativeOcrZoneRecognitionModule.MatrixMatching
NativeOcrZoneFillMethod.OcrA	NativeOcrZoneRecognitionModule.MatrixMatching
NativeOcrZoneFillMethod.OcrB	NativeOcrZoneRecognitionModule.MatrixMatching
NativeOcrZoneFillMethod.Omr	NativeOcrZoneRecognitionModule.Omr
NativeOcrZoneFillMethod.Icr	NativeOcrZoneRecognitionModule.IcrNumeral or NativeOcrZoneRecognitionModule.IcrCharacter
NativeOcrZoneFillMethod.OmniFont	NativeOcrZoneRecognitionModule.OmniFontMText or NativeOcrZoneRecognitionModule.OmniFontMor
NativeOcrZoneFillMethod.DraftDotMatrix9	NativeOcrZoneRecognitionModule.OmniFontMText or NativeOcrZoneRecognitionModule.OmniFontMor
NativeOcrZoneFillMethod.DraftDotMatrix24	NativeOcrZoneRecognitionModule.OmniFontMText or NativeOcrZoneRecognitionModule.DotMatrix
NativeOcrZoneFillMethod.CMC7	NativeOcrZoneRecognitionModule.IcrCharacter

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. The last three will be directed to NativeOcrZoneRecognitionModule.OmniFontMText, unless the engine finds a language, filter or other setting which is not supported by this module.

With the NativeOcrZoneFillMethod.Icr and NativeOcrZoneRecognitionModule.IcrCharacter will be chosen if letters or other characters unsupported by NativeOcrZoneRecognitionModule.IcrNumeral are validated for recognition.

As an example, suppose the zone's fill method is NativeOcrZoneFillMethod.OmniFont and NativeOcrZoneRecognitionModule.Auto has been specified.

If only English and/or the main West European language characters are to be validated for recognition, then the M/TEXT omnifont recognition module (NativeOcrZoneRecognitionModule.OmniFontMText) will be automatically selected.
However, if e.g. Polish characters are also to be recognized, the engine will select the multi-lingual MOR omnifont recognition module NativeOcrZoneRecognitionModule.OmniFontMor, since the M/TEXT recognition module does not support Polish characters, but the MOR recognition module does.

Requirements

Target Platforms