CRasterImage::Paste

void Paste( CRasterImage & dst, POINT location, bool srcCopy = true ) const;
void Paste( CRasterImage & dst, int xPos, int yPos, bool srcCopy = true ) const;

Parameters

dst Destination for the paste operation. Whole image content of the CRasterImage object will be pasted into the destination object
location x and y coordinates of the left bottom paste-rectange corner in the destination image. Coordinates must be specified using OpenGL convention.
xPos, yPos x and y coordinates of the left bottom paste-rectange corner in the destination image. Coordinates must be specified using OpenGL convention.
srcCopy

if true then exact source image content will be pasted into destination image.

If false and source image has alpha channel then values of the source image alpha channel will be used to blend source image into destination image. If for example source pixel's alpha value is 0% then source pixel won't be pasted into destination pixel. If source pixel's alpha value is 100% then source pixel colors will replace original destination pixel colors. If for example source pixel's alpha value is 70% then destination pixel will be blended from 70% color of source pixel and 30% of original destination pixel color value.

Remarks

The Paste function copies whole image content of the CRasterImage object into destination object. Previous content and storage type of the destination object will be kept except the rectangle where the source image will be pasted. Destination image's dimensions and alpha values will always remain unchanged during paste operation.

Position of paste rectangle must be specified using OpenGL convention where Y coordinates grow from bottom to top. It means that vertically lower point must have lower numerical Y coordinate value than a pixel which is vertically higher.

If source image dimensions in combination with specified paste location are passing current destination object image dimensions then only overlapping portion of source image will be pasted into destination image.

This function is available since ClassGL version 3.6.10.

See Also

CRasterImage class methods