BitBltPlaneMasked

Copy a block of video memory with an associated bit plane mask

Declaration

void NAPI GA_2DRenderFuncs::BitBltPlaneMasked(
    N_int32 srcLeft,
    N_int32 srcTop,
    N_int32 width,
    N_int32 height,
    N_int32 dstLeft,
    N_int32 dstTop,
    N_uint32 planeMask)

Prototype In

snap/graphics.h

Parameters

srcLeft

Left coordinate of the source rectangle to copy

srcTop

Top coordinate of the source rectangle to copy

width

Width of the rectangle in pixels

height

Height of the rectangle in scanlines

dstLeft

Left coordinate of destination

dstTop

Top coordinate of destination

planeMask

Plane mask to use during the copy

 

Description

This function copies a rectangular region of video memory from one location to another. This routine will copy a rectangular region of video memory from (srcLeft, srcTop, srcLeft+width-1, srcTop+height-1) to (dstLeft, dstTop) within video memory with the specified plane mask. The plane mask is used to determine which bits in the destination pixels will be affected by the copy. Each bit in the plane mask is used to mask out a bit in the destination pixel values, and where a bit is a 1 the destination bit comes from the source pixel while where a bit is 0 the destination bit is left unchanged.

See Also

BitBlt, BitBltPlaneMaskedLin, BitBltPlaneMaskedSys, BitBltPlaneMaskedBM

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com