IG_clipboard_paste_merge

This function pastes a rectangular or non-rectangular clipboard image into the HIGEAR image that you specify.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_clipboard_paste_merge_ex( HIGEAR hIGear, AT_PIXPOS nLeftPos, AT_PIXPOS nTopPos );

Arguments:

Name	Type	Description
hIGear	HIGEAR	Set to the HIGEAR handle of the image in which to merge the clipboard contents.
nLeftPos	AT_PIXPOS	X position in HIGEAR image at which to place the upper left corner of the clipboard image when merging.
nTopPos	AT_PIXPOS	Y position in HIGEAR image at which to place the upper left corner of the clipboard image when merging.

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:

Indexed RGB – 1, 4, 8 bpp;
RGB – 24 bpp.

Example:

	Copy Code
AT_ERRCOUNT nErrcount; HIGEAR hIGear; BOOL bNRpasteAvail; AT_PIXPOS xpos, ypos; AT_MODE nRegionType; nErrcount = IG_clipboard_paste_available_ex(&bNRpasteAvail, &nRegionType); nErrcount = IG_clipboard_paste_merge_ex(hIGear, xpos, ypos);

Copy Code

AT_ERRCOUNT nErrcount;
HIGEAR  hIGear;
BOOL    bNRpasteAvail;
AT_PIXPOS       xpos, ypos;
AT_MODE         nRegionType;
nErrcount = IG_clipboard_paste_available_ex(&bNRpasteAvail, &nRegionType);
nErrcount = IG_clipboard_paste_merge_ex(hIGear, xpos, ypos);

Remarks:

To check if there is a paste-able image on the clipboard, call IG_clipboard_paste_available_ex().

nLeftPos and nTopPos set the (x,y) coordinates of the upper-left corner of the bounding rectangle of the original image. See image below. The image has an (x,y) location within it at which the upper left-corner of the bounding rectangle will be placed. The white circle enclosed within a gray rectangle represents the non-rectangular ROI image stored in the clipboard, where the shaded area represents the transparent area between the bounding rectangle and the non-rectangular ROI. When the clipboard image is merged, only the circle will appear on the image.

Use IG_clipboard_paste_op_set() to tell ImageGear what kind of merge operation to perform.

This function will automatically call IG_clipboard_paste_available_ex() to confirm that there is data available. Therefore, it is not mandatory to call IG_clipboard_paste_available_ex() before making this call, unless you are interested in knowing the type of region contained in the clipboard.