| Home
| Previous
| Next
| Up

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