ImageGear for C and C++ on Windows v19.3 - Updated
IG_REC_free
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Utility Functions > IG_REC_free

Destroys memory object being allocated with such functions as IG_REC_letters_get, IG_REC_zone_layout_get, IG_REC_zone_node_array_get.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_free(
   LPVOID lpObject
);

Arguments:

Name Type Description
lpObject LPVOID Object to be destroyed.

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;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;
LPAT_REC_LETTER pLetters  = 0;
AT_INT nLength  = 0;

ErrCount += IG_load_file("Image.tif", &higImage); 
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_image_recognize(higRecImage);
ErrCount += IG_REC_letters_get(higRecImage, &pLetters, &nLength);
ErrCount += IG_REC_free((LPVOID)pLetters);

//...

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