ImageGear for C and C++ on Linux v19.10 - Updated
IG_clipboard_copy
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Clipboard Functions > IG_clipboard_copy

This function copies the specified portion of the image to the system clipboard.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_clipboard_copy ( 
        HIGEAR hIGear, 
        const LPAT_RECT lprcRectToCopy 
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of the current image.
rcRectToCopy const LPAT_RECT Far pointer to an AT_RECT struct specifying the rectangular portion of the image that is to be copied to the clipboard.

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

The copied pixels will be converted to 1-, 4-, 8-bit indexed or 24-bit RGB format for copying to the clipboard.

Example:

 
Copy Code
HIGEAR       hIGear;        /* HIGEAR handle of image  */
AT_RECT      rcRectToCopy;  /* Rectangle of image to copy to clipboard */
AT_DIMENSION nImageWidth;    /* Width of image  */
AT_DIMENSION nImageHeight;  /* Height of image  */
/* Copy bottom half of image to system clipboard:  */
rcRectToCopy.left   = 0;
rcRectToCopy.top    = nImageHeight / 2;
rcRectToCopy.right  = nImageWidth - 1;
rcRectToCopy.bottom = nImageHeight - 1;
IG_clipboard_copy ( hIGear, &rcRectToCopy );

Remarks:

If rcRectToCopy = NULL, the entire image will be copied.

This function, like other ImageGear Image Processing and Clipboard API calls, takes an AT_RECT structure as an argument, so that you can process a rectangular sub-region of an image. However, before ImageGear performs the operation specified by this function, it will check to see if an internal flag has been set to TRUE, indicating that a mask HIGEAR should be used with the image. If the flag is set to TRUE, and a valid pointer to a mask image has been assigned, ImageGear will override the settings passed to the AT_RECT structure and use the non-rectangular ROI defined by the mask HIGEAR. To create a non-rectangular region of interest, call IG_IP_NR_ROI_to_HIGEAR_mask().

Please see the descriptions of IG_IP_NR_ROI_mask_associate() and IG_IP_NR_ROI_to_HIGEAR_mask() functions for more details.