ImageGear for C and C++ on Windows v19.4 - Updated
IG_REC_decomp_nongridded_table_detect_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Zone Support Functions > IG_REC_decomp_nongridded_table_detect_set

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

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_decomp_nongridded_table_detect_set(
   AT_BOOL bEnable
);

Arguments:

Name Type Description
bEnable AT_BOOL Non-gridded table detection setting to be set.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
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:

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).