ImageGear for C and C++ on Windows v19.1 - Updated
IG_REC_image_export
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Recognition Image Preprocessing Functions > IG_REC_image_export

Exports an image from the recognition engine to ImageGear's HIGEAR.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_image_export(
   HIG_REC_IMAGE hRecImage,
   LPHIGEAR lphIGear
);

Arguments:

Name Type Description
hRecImage HIG_REC_IMAGE Handle of the recognition image.
lphIGear LPHIGEAR Pointer to a variable to receive the new HIGEAR image.

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 higImageImport = 0;
HIGEAR higImageExport = 0;
HIG_REC_IMAGE higRecImage = 0;

ErrCount += IG_load_file("Image.tif", &higImageImport); 
ErrCount += IG_REC_image_import(higImageImport, &higRecImage);
ErrCount += IG_REC_image_export(higRecImage, &higImageExport);

//...

ErrCount += IG_image_delete(higImageImport);
ErrCount += IG_image_delete(higImageExport);
ErrCount += IG_REC_image_delete(higRecImage);

Remarks:

If the image pixel format is not supported by the Recognition engine natively, ImageGear converts the image into one of the supported raster image formats during the import. As a result, after exporting such image back to HIGEAR, its pixel format may differ from the original one. Please see IG_REC_image_import for additional details on this conversion.

The exported image will have one of these pixel formats:

See Also

HIG_REC_IMAGE