Set the Non-gridded table detection setting of the recognition engine.

Declaration:

AT_ERRCOUNT ACCUAPI IG_REC_decomp_nongridded_table_detect_set(
   AT_BOOL bEnable
);

Arguments:

Return Value:

Supported Raster Image Formats:

This function does not process image pixels.

Example:

AT_ERRCOUNT ErrCount = 0;
ErrCount = IG_REC_decomp_nongridded_table_detect_set(TRUE);

Remarks:

Tables with visible gridlines ("gridded" tables) in an original page can usually be detected successfully by the auto-zoning function. In contrast, tables without visible cell separators in the original are harder to identify as tables, because they could equally as well be word lists or data arranged in columns. The Recognition component offers an algorithm for detecting such non-gridded tables more confidently. This feature of the recognition engine can only be used in conjunction with an auto-zoning step. The algorithm is based on the result of the character recognition.

When this feature is enabled, a special algorithm tries to find non-gridded table(s) on the image. This algorithm is based on the existing zone list of the image and also on the recognized characters, i.e., this algorithm is activated as one of the last steps in the character recognition.

Because of this, its effect might be visible only after a IG_REC_image_recognize call.

The running of this algorithm is strongly controlled, since it may change the zone list belonging to the image. Accordingly, the non-gridded table detection feature may be allowed to run only if all the following conditions are met:

• The zone list was created through auto-zoning (IG_REC_zones_locate)
• There was no change in the zone list (no zone was inserted - IG_REC_zone_insert, deleted - IG_REC_zone_delete, etc.)
• None of the zones in zone list was updated by modifying the zone coordinates (IG_REC_zone_info_set).

Disabling the Non-gridded table detection algorithm is recommended when the IG_REC_DCM_FAST page parser algorithm is selected (see: IG_REC_decomp_method_set).