This documentation is archived and is not being maintained.

AfxDrawDitheredBitmap

Draws a bitmap, replacing its background with a dithered (checker) pattern.

void AFXAPI AfxDrawDitheredBitmap( 
   CDC *pDC, 
   int x, 
   int y, 
   const CBitmap &rSrc, 
   COLORREF cr1, 
   COLORREF cr2 
);

pDC

Points to the destination DC.

x

The destination x-coordinate.

y

The destination y-coordinate.

rSrc

The source bitmap.

cr1

One of the two dither colors, typically white.

cr2

The other dither color, typically light gray (COLOR_MENU).

The source bitmap is drawn on the destination DC with a two-color (cr1 and cr2) checkered pattern replacing the bitmap's background. The background of the source bitmap is defined as its white pixels and all pixels matching the color of the pixel in the upper-left corner of the bitmap.

Dither Bitmap Sample

void CDCView::DrawDitheredBitmap(CDC* pDC)
{
   CBitmap bm;
   bm.LoadBitmap(IDB_BITMAP1);
   AfxDrawDitheredBitmap(pDC, 10, 50, bm, RGB(255,255,255),
      GetSysColor(COLOR_BTNFACE));
}

Header: afxwin.h

Show: