MGL_copyPageCoord
Blts a block of image data from one page in a display device context to another page within the same device context.
Declaration
void MGLAPI MGL_copyPageCoord(
MGLDC *dc,
int srcPage,
int left,
int top,
int right,
int bottom,
int dstLeft,
int dstTop,
int op)
Prototype In
mgraph.h
Parameters
dc |
Destination device context |
srcPage |
Page in DC to get the source data from |
left |
Left coordinate of image to Blt from |
top |
Top coordinate of image to Blt from |
right |
Right coordinate of image to Blt from |
bottom |
Bottom coordinate of image to Blt from |
dstLeft |
Left coordinate to Blt to |
dstTop |
Right coordinate to Blt to |
op |
Write mode to use during Blt |
Description
Copies a block of bitmap data from the source page in the destination device context to the currently active page. This routine has been highly optimized for absolute maximum performance, so it will provide the fastest method of copying bitmap data between two different pages in a display device context.
The write mode operation specifies how the source image data should be combined with the destination image data. Write modes supported by the SciTech MGL are enumerated in MGL_writeModeType.
The destination rectangle is clipped according to the current clipping rectangles for the destination device context. However the source rectangle is only clipped to the bounds of the source page dimensions and is not clipped to the source clip rectangle. Also the source coordinates are global screen coordinates and are not viewport translated. You will need to do your own viewport translation as necessary.
Note: This function will utilise the hardware whenever available to speed up the blitting of data between display pages. However if the end user system does not have hardware screen to screen blit operations (or the underlying device driver does not support this), then the copy operation will be quite slow. It would be faster in this case to do all rendering to a system memory DC and blit that to the screen instead of doing software blit's between two display pages.
See Also
MGL_bitBlt, MGL_bitBltCoord, MGL_srcTransBlt, MGL_srcTransBltCoord, MGL_dstTransBlt, MGL_dstTransBltCoord, MGL_bitBltPatt, MGL_bitBltPattCoord, MGL_bitBltFx, MGL_bitBltFxCoord, MGL_stretchBlt, MGL_stretchBltCoord, MGL_stretchBltFx, MGL_stretchBltFxCoord, MGL_copyPage, MGL_copyPageCoord
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com