Fade a Bitmap Using Palette Animation

ID: Q130804

The information in this article applies to:

Microsoft Win32 Application Programming Interface (API), used with:
- Microsoft Windows NT, versions 3.5, 3.51, 4.0
- Microsoft Windows 95
Microsoft Windows 2000

SUMMARY

PALFADE is a sample application available in the Microsoft Software Library. It demonstrates:

How to use the AnimatePalette function to fade a bitmap to black.

How to use the DIBAPI32.DLL library that can be built by the WINCAP32 sample that ships with the Microsoft Win32 SDK.

To perform palette animation, the sample creates a logical palette for a Device-Independent Bitmap (DIB) with the PC_RESERVED flag set for each palette entry. PALFADE loads, displays, and animates both Windows-style and OS/2-style DIB files.

MORE INFORMATION

The following file is available for download from the Microsoft Download Center. Click the file name below to download the file:

Palfade.exe

For more information about how to download files from the Microsoft Download Center, please visit the Download Center at the following Web address

http://www.microsoft.com/downloads/search.asp

and then click How to use the Microsoft Download Center.

Before performing palette animation on a logical palette entry, ensure that the palette entry has the PC_RESERVED flag set. To fade a bitmap drawn on a device context with a PC_RESERVED palette selected, you can lower the RGB values for each color in the palette in a loop until all colors are black.

The default system palette contains 20 static colors. These static colors take up the first ten and last ten colors of the system palette; these palette entries are not available for animation. If you try to fade a bitmap that has 256 unique colors by creating a 256-color palette with each palette entry set to PC_RESERVED, you are not guaranteed that every logical palette entry will map to an entry in the system palette that is available for palette animation.

One solution to this is to create a logical palette that contains only 236 colors. The PALFADE sample demonstrates one way to create an optimal palette of 236 colors given a device-independent bitmap with 256 colors in its color table.

Given a 256-color DIB, PALFADE traverses through every bit in the bitmap to find the least-used 20 colors in the color table. Then it creates a logical palette out of the 236 most-used colors. This ensures that all entries in the logical palette will animate.

This sample uses many of the DIB support functions included with the DIBAPI32.DLL library. It does not use the LoadDIB() function, because it was not written to handle OS/2-style DIB files. Instead, PALFADE implements the DIB-loading routines found in the Win32 SDK SHOWDIB sample.

NOTE: DIBAPI32.DLL is included with this sample.

Additional query words: kbgraphic kbfile

Keywords : kbfile kbgraphic kbNTOS350 kbNTOS351 kbWinOS2000 kbSDKWin32 kbGDIFAQ
Version : WINDOWS:; winnt:3.5,3.51,4.0
Platform : WINDOWS winnt
Issue type : kbinfo