| Home
| Previous
| Next
| Up

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