ImageGear for C and C++ on Windows v19.9 - Updated
AT_REC_ZONE
API Reference Guide > Recognition Component API Reference > Recognition Component Structures Reference > 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;

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.