Supported Browsers Home   
MGL_copyPage Previous   
MGL_copyRegion Next   
External Functions 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