MGL_putBitmapDstTransSection

Draw a section of a transparent lightweight bitmap at the specified location with destination transparency.

Declaration

void MGLAPI MGL_putBitmapDstTransSection(
MGLDC *dc,
int left,
int top,
int right,
int bottom,
int dstLeft,
int dstTop,
const bitmap_t *bitmap,
color_t transparent,
int op)

Prototype In

mgraph.h

Parameters

dc | Device context to display bitmap on
left | Left coordinate of section to draw
top | Top coordinate of section to draw
right | Right coordinate of section to draw
bottom | Bottom coordinate of section to draw
dstLeft | Left coordinate of destination of bitmap section
dstTop | Right coordinate for destination of bitmap section
bitmap | Bitmap to display
transparent | Transparent color for the bitmap
op | Write mode to use when drawing bitmap

Description

Draws a section of a transparent lightweight bitmap at the specified location with 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: If you are doing pixel format conversion at the same time (ie: color depth for source bitmap is different to the destination bitmap), then the transparent color value must be set to the traslated destination pixel format. Ie: if you are blitting an 8bpp bitmap to a 32bpp device context, the transparent color must be a 32bpp value.

Note: This routine also only works with pixel depths that are at least 4 bits deep.

See Also

MGL_loadBitmap, MGL_putBitmap, MGL_putBitmapSection, MGL_putBitmapSrcTrans, MGL_putBitmapSrcTransSection, MGL_putBitmapDstTrans, MGL_putBitmapDstTransSection, MGL_putBitmapMask, MGL_putBitmapPatt, MGL_putBitmapPattSection, MGL_putBitmapFx, MGL_putBitmapFxSection, MGL_stretchBitmap, MGL_stretchBitmapSection, MGL_stretchBitmapFx, MGL_stretchBitmapFxSection, MGL_putIcon

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