Supported Browsers Home   
BitBltColorPattSys Previous   
BitBltFxBM Next   
GA_2DRenderFuncs Up   

BitBltFx

Copy a block of video memory to another location in video memory with optional effects.

Declaration

void NAPI GA_2DRenderFuncs::BitBltFx(
    N_int32 srcLeft,
    N_int32 srcTop,
    N_int32 srcWidth,
    N_int32 srcHeight,
    N_int32 dstLeft,
    N_int32 dstTop,
    N_int32 dstWidth,
    N_int32 dstHeight,
    GA_bltFx *fx)

Prototype In

snap/graphics.h

Parameters

srcLeft

Left coordinate of the source rectangle to copy

srcTop

Top coordinate of the source rectangle to copy

srcWidth

Width of the source rectangle in pixels

srcHeight

Height of the source rectangle in scanlines

dstLeft

Left coordinate of destination

dstTop

Top coordinate of destination

dstWidth

Width of the destination rectangle in pixels

dstHeight

Height of the destination rectangle in scanlines

fx

GA_bltFx structure describing the requested effects

 

Description

This function copies a rectangular region of video memory from one location to another with the optional effects described in the GA_bltFx structure. Currently this function can perform stretching, source and destination transparency and flipping depending on what features the underlying hardware supports, with an optional mix code. This routine will copy the rectangular region of video memory from (srcLeft, srcTop, srcLeft+srcWidth-1, srcTop+srcHeight-1) to (dstLeft, dstTop, dstLeft+dstWidth-1, dstTop+dstHeight-1) within video memory. Note that the source and destination rectangle dimensions may be different in, which is the case for doing a copy with bitmap stretching. If the GA_bltFx structure does not indicate stretching is in effect, the dstHeight and dstWidth parameters will be ignored and only the srcWidth and srcHeight parameters will be used. The results of this routine are undefined if the video memory regions overlap.

Note:    Some of the features may not be supported at the same time, and it is up to the application programmer to call the BitBltFxTest function to determine what features are supported before calling this function. Calling this function with an unsupported set of features will result in undefined behaviour.

See Also

BitBltFxTest, BitBltFxLin, BitBltFxSys, BitBltFxBM, SrcTransBlt, DstTransBlt, BitBlt

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