ImageGear for C and C++ on Linux - Updated
IG_clipboard_paste_op_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Clipboard Functions > IG_clipboard_paste_op_set

This function sets the kind of operation to use for future calls to IG_clipboard_paste_merge_ex().

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_clipboard_paste_op_set (
        HIGEAR hIGear, 
        AT_MODE nOperation
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of the image that is in the system.
nOperation AT_MODE An integer constant of type AT_MODE, which will be used in future calls to IG_clipboard_paste_merge_ex().

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:

This function does not process image pixels.

Example:

 
Copy Code
HIGEAR       hIGear;         /* HIGEAR handle of image      */
AT_ERRCOUNT  nErrcount       /* # of IG errors on the stack */
nErrcount = IG_clipboard_paste_op_set( hIGear, IG_ARITH_AND );

Remarks:

nOperation is an integer constant of type AT_MODE that is defined in accucnst.h. Here are the possible settings and what kind of operation each one will perform on the values of the merging pixels:

IG_ARITH_ADD Img1 = Img1 + Img2
IG_ARITH_SUB Img1 = Img1 - Img2
IG_ARITH_MULTI Img1 = Img1 * Img2
IG_ARITH_DIVIDE Img1 = Img1 / Img2
IG_ARITH_AND Img1 = Img1 & Img2
IG_ARITH_OR Img1 = Img1 | Img2
IG_ARITH_XOR Img1 = Img1 ^ Img2
IG_ARITH_ADD_SIGN_CENTERED Img1 = Img1 + SC_Img2
IG_ARITH_NOT Img1 = ~Img1
IG_ARITH_OVER Img1 = Img2

You can also set nOperation to 0, which is the default. This will cause the image in the clipboard to just be copied over the currently loaded image - no merging of intersecting pixel values will occur.