ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_zones_save
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Zone Support Functions > IG_REC_zones_save

Glossary Item Box

Saves the current zone list of the hImage image into a zone file.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_zones_save(
   HIG_REC_IMAGE hImage,
   const LPSTR lpFileName
);

Arguments:

hImage Handle of the image.
lpFileName Name of the zone file to be created.

Return Value:

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

Supported Raster Image Formats:

See IG_REC_image_import.

Remarks:

  1. This function overwrites a pre-existing zone file with the same name.
  2. The zone coordinates are saved in the zone file in twips (1/1440 inches).

Example:

  Copy Code
AT_ERRCOUNT ErrCount = 0;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;

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

//...

ErrCount += IG_REC_zones_save(higRecImage, "zones_file.zf");

//...

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

See Also

HIG_REC_IMAGE

©2012. Accusoft Corporation. All Rights Reserved.