MGL_putBufferDstTransSection

Copy a section of an offscreen buffer to the specified location with destination transparency.

Declaration

void MGLAPI MGL_putBufferDstTransSection(
    MGLDC *dc,
    int left,
    int top,
    int right,
    int bottom,
    int dstLeft,
    int dstTop,
    MGLBUF *buf,
    color_t transparent,
    int op)

Prototype In

mgraph.h

Parameters

dc

Device context to copy buffer to

left

Left coordinate of section to copy

top

Top coordinate of section to copy

right

Right coordinate of section to copy

bottom

Bottom coordinate of section to copy

dstLeft

Left coordinate of destination to copy buffer to

dstTop

Right coordinate of destination to copy buffer to

buf

Buffer to copy

transparent

Transparent color for the bitmap

op

Write mode to use when drawing buffer

 

Description

Copies a section of an offscreen buffer to the specified location on the device context with either source or destination transparency.

When transferring the data with destination transparency, pixels in the destination image that are equal to the specified transparent color will be updated, and those pixels that are not the same will be skipped. This is effectively the operation performed for 'blueScreen'ing or color keying and can also be used for drawing transparent sprites. Note however that destination transparency is very slow in software compared to source transparency!

Note:    This function will fail if you attempt to copy a buffer to a device context that is not the device context that the original buffer was allocated for.

See Also

MGL_copyToBuffer, MGL_copyBitmapToBuffer, MGL_updateBufferCache, MGL_updateFromBufferCache, MGL_putBuffer, MGL_putBufferSection, MGL_putBufferSrcTrans, MGL_putBufferSrcTransSection, MGL_putBufferDstTrans, MGL_putBufferDstTransSection, MGL_putBufferPatt, MGL_putBufferPattSection, MGL_putBufferFx, MGL_putBufferFxSection, MGL_stretchBuffer, MGL_stretchBufferSection, MGL_stretchBufferFx, MGL_stretchBufferFxSection

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