ImageGear for C and C++ on Linux v18.8 - Updated
IG_image_duplicate
API Reference Guide > Core Component API Reference > Core Component Functions Reference > General Image Functions > IG_image_duplicate

This function creates an exact duplicate of the current HIGEAR image, and returns the handle to the new image to you in lphIGear.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_image_duplicate (
        HIGEAR hIGear, 
        LPHIGEAR lphIGear
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the current image to be duplicated.
lphIGear LPHIGEAR A far pointer in which the handle of the new, duplicate image is returned.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

 All pixel formats supported by ImageGear for C and C++.

Example:

 
Copy Code
HIGEAR hIGear;/* HIGEAR handle of image  */
HIGEAR lphIGear;  /* HIGEAR handle to new duplicate image   */
IG_image_duplicate(hIGear, &lphIGear);