IG_REC_image

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

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:

Indexed RGB - 1, 8 bpp;
Grayscale - 8 bpp;
RGB - 24 bpp.