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
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 Software
Library:
~ PALFADE.EXE
For more information about downloading files from the Microsoft Software
Library, please see the following article in the Microsoft Knowledge Base:
Q119591
How to Obtain Microsoft Support Files from Online Services
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 kbSDKWin32
Version : winnt:3.5,3.51,4.0
Platform : winnt
Issue type : kbinfo
Last Reviewed: June 21, 1999