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

Deletes a zone from the zone list of the hImage image.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_zone_delete(
   HIG_REC_IMAGE hImage,
   AT_INT iZoneIndex
);

Arguments:

Name Type Description
hImage HIG_REC_IMAGE Handle of the image.
iZoneIndex AT_INT Index in the zone list of the zone to be deleted.

Return Value:

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

Supported Raster Image Formats:

See IG_REC_image_import.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
HIG_REC_IMAGE higRecImage = 0;
HIGEAR higImage = 0;
AT_INT iZoneCount = 0;
AT_INT iZoneIndex = 0;

ErrCount += IG_load_file("Multipage.tif", &higImage); 
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_zones_locate(higRecImage, NULL);
ErrCount += IG_REC_zones_count_get(higRecImage, &iZoneCount);

for(iZoneIndex = iZoneCount-1; iZoneIndex >= 0; iZoneIndex--)
    ErrCount += IG_REC_zone_delete(higRecImage, iZoneIndex);

ErrCount += IG_REC_image_delete(higRecImage);
ErrCount += IG_image_delete(higImage);

Remarks:

  1. The index of the first zone in the zone list is zero (0).
  2. Calling this function disables the non-gridded table detection algorithm, independently from the nongridded table detection setting. For more detail see the IG_REC_decomp_nongridded_table_detect_set function.

See Also

HIG_REC_IMAGE