ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / General Image Functions / IG_image_duplicate
In This Topic
    IG_image_duplicate
    In This Topic

    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++.

    Sample:

    Color, Image Processing

    Example:

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