References ▼
typedef struct _tagZoneData2{L_UINT uStructSize;RECT rcArea;DOC2_FILLMETHOD FillMethod;DOC2_RECOGMODULE RecogModule;[DOC2_CHAR_FILTER](doc2-char-filter.md) CharFilter;DOC2_ZONETYPE Type;L_UINT uFlags;L_CHAR szSection[DOC2_MAX_SECTION_NAME_LENGTH];VERIFICATIONCALLBACK2 pfnCallback;L_VOID * pUserData;} ZONEDATA2, * pZONEDATA2;
The ZONEDATA2 structure provides zone information. This structure contains all the information necessary to describe a zone. A zone is a rectangular area on an image containing a feature of interest to the user. The image data covered by each zone is handled and processed (typically recognized) separately.
| Member | Description | |
| uStructSize | Structure size. It should be equal to sizeof(ZONEDATA2). | |
| rcArea | Coordinates of the zone (RECT) | |
| FillMethod | Zone filling method. For a list of possible values, refer to DOC2_FILLMETHOD. | |
| RecogModule | Recognition module associated with the zone. For a list of possible values, refer to DOC2_RECOGMODULE. | |
| CharFilter | Character Set filter for the zone. For a list of possible values, refer to DOC2_CHAR_FILTER. | |
| Type | Zone type. For a list of possible values, refer to DOC2_ZONETYPE. | |
| uFlags | Flags that control the checking process. These values can be combined using OR (|). Possible values are: | |
| Value | Meaning | |
| DOC2_ZONE_CHK_LANGDICT_PROHIBIT | [0x00000001] Prohibit the use of the Language dictionary. | |
| DOC2_ZONE_CHK_USERDICT_PROHIBIT |
[0x00000002] Prohibit the use of the User dictionary. NOTE: User words and dictionaries are no longer supported in the OCR Professional Engine. |
|
| DOC2_ZONE_CHK_CHECKCBF_PROHIBIT | [0x00000004] Prohibit the use of the user-written checking callback function. | |
| DOC2_ZONE_CHK_VERTDICT_PROHIBIT | [0x00000008] Prohibit the use of the Vertical dictionary. | |
| DOC2_ZONE_CHK_IGNORE_WHITESPACE | [0x00000010] Ignore white space characters (SPACE and TAB characters) during checking. This field should be used together with the DOC2_ZONE_CHK_PASS_LINES flag. | |
| DOC2_ZONE_CHK_IGNORE_CASE |
[0x00000020] Ignore case when checking with the User Dictionary. NOTE: User words and dictionaries are no longer supported in the OCR Professional Engine. |
|
| DOC2_ZONE_CHK_PASS_LINES | [0x00000040] Have the DOC2_RECOGMODULE pass entire lines to the checker, instead of words. Do not use this attribute in conjunction with spell checking. | |
| DOC2_ZONE_CHK_CORRECTION_DISABLED | [0x00000080] Disable Spell checking even if it is enabled at page-level | |
| DOC2_ZONE_CHK_INCLUDE_PUNCTUATION | [0x00000100] Consider punctuation characters on the boundaries of the strings, as well. | |
| DOC2_ZONE_CHK_CORRECT_PROPERNAMES | [0x00000200] Enable the correcting of words beginning with an uppercase letter inside a sentence (i.e. typically but not always proper names) | |
| DOC2_ZONE_CHK_LANGDICT_USED | [0x00010000] "After recognition flag": the Language dictionary was enabled during the checking process (spell checking was activated for the zone) | |
| DOC2_ZONE_CHK_USERDICT_USED |
[0x00020000] "After recognition flag": the User dictionary was enabled during the checking process (UD-checking was activated for the zone). NOTE: User words and dictionaries are no longer supported in the OCR Professional Engine. |
|
| DOC2_ZONE_CHK_CHECKCBF_USED | [0x00040000] "After recognition flag": a user-written checking callback function was enabled during the checking process (user-written checking was activated) | |
| szSection |
Contains a null terminated string (for instance, the section name in the User dictionary is assigned to the zone or an empty string). NOTE: User words and dictionaries are no longer supported in the OCR Professional Engine. |
|
| pfnCallback | Address of a user-written verification callback function (VERIFICATIONCALLBACK2 function) or NULL. | |
| pUserData | More user data used in pUserData parameter of the VERIFICATIONCALLBACK2 function | |
This structure contains all of the information necessary to describe the bounding box for a zone.
A pizzabox shape is a union of rectangles, where the top of each rectangle in the union must touch the bottom of the rectangle above it. A rectangle can touch at most one rectangle above and one below. Conversely, table zones cannot have a pizzabox shape since they have cells above, below, and on one or more side.
Zones in an image are built into a sequential list, called the zone list. Each zone receives an internal index number, reflecting its position in this list. In some cases this zone order even determines the zone content order in the final output document. The index of the first zone in the zone list is zero (0).
pZONEDATA2 is a pointer to a ZONEDATA2 structure. If the function parameter type is pZONEDATA2, declare a ZONEDATA2 variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pZONEDATA2 variable is necessary only if the program requires a pointer.