AT_REC_ZONE

The AT_REC_ZONE structure contains all the necessary information for describing a zone. A zone is a rectangular or "pizza box" shaped area on an image, but AT_REC_ZONE contains only its bounding box. It contains a feature of interest to the user. The image data covered by each zone is handled and processed (typically recognized) separately. A very first classification of the zones is their type: whether a zone's area is to be recognized or it should be treated as graphic. Zones containing textual information can be either flowed type or table type zones. This basic classification of zones helps the Engine to handle the textual information correctly. Zones are always associated with a enumIGRecFillingMethod filling method and one of the available enumIGRecRecognitionModule recognition modules. These determine what kind of recognition algorithm will be applied to the zone during its processing. For possible RM-FM pairs see documentation for enumIGRecRecognitionModule. Zones in a page 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).

Declaration:

	Copy Code
typedef struct tagAT_REC_ZONE { enumIGRecZoneCheckingFlags Checking; LPFNIG_REC_WORD_CHECK CheckWordCB; enumIGRecFillingMethod FillingMethod; enumIGRecChrFilter Filter; enumIGRecRecognitionModule RecognitionModule; AT_RECT Rect; enumIGRecZoneType Type; AT_DWORD UserData; AT_CHAR UserDictionarySection[AM_MAX_UD_SECTION_NAME_LEN]; } AT_REC_ZONE, * LPAT_REC_ZONE;

Copy Code

typedef struct tagAT_REC_ZONE
{
   enumIGRecZoneCheckingFlags Checking;
   LPFNIG_REC_WORD_CHECK CheckWordCB;
   enumIGRecFillingMethod FillingMethod;
   enumIGRecChrFilter Filter;
   enumIGRecRecognitionModule RecognitionModule;
   AT_RECT Rect;
   enumIGRecZoneType Type;
   AT_DWORD UserData;
   AT_CHAR UserDictionarySection[AM_MAX_UD_SECTION_NAME_LEN];

} AT_REC_ZONE, * LPAT_REC_ZONE;

Structure Members:

Name	Type	Description
Checking	enumIGRecZoneCheckingFlags	Checking control bit mask flag. It controls how the checking module will check the recognized result for the zone.
CheckWordCB	LPFNIG_REC_WORD_CHECK	This member has been deprecated and will be removed from the public API in a future release. Address of a user-written checking callback function or NULL.
FillingMethod	enumIGRecFillingMethod	Zone filling method (enumIGRecFillingMethod).
Filter	enumIGRecChrFilter	Character Set filter for the zone. It is used to modify the set of valid characters for recognition of the zone. Specifying the Character Set correctly is a recognition accuracy issue.
RecognitionModule	enumIGRecRecognitionModule	Recognition module associated with the zone.
Rect	AT_RECT	Bounding box of the rects. To obtain the exact layout of the zone call IG_REC_zone_layout_get.
Type	enumIGRecZoneType	Zone type.
UserData	AT_DWORD	User-defined content. This field can be freely used by the application for storing zone-specific information.
UserDictionarySection	AT_CHAR	This member has been deprecated and will be removed from the public API in a future release. Contains a null terminated string, such as the section name in the User dictionary assigned to the zone or an empty string for the default section.