//-----------------------------------------------------------------------------
//
// Sample Name: AnimatePalette Sample
//
// Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
Description
===========
AnimatePalette demonstrates DirectDraw palette animation when in full-screen
on a palettized surface.
Path
====
Source: DXSDK\Samples\Multimedia\DDraw\AnimatePalette
Executable: DXSDK\Samples\Multimedia\DDraw\Bin
User's Guide
============
AnimatePalette requires no user input. Press the ESC key to quit the program.
Programming Notes
=================
For details on how to setup a full-screen DirectDraw app, see the FullScreenMode
sample.
To animate the palette on a palettized DirectDraw surface, call
IDirectDrawPalette::GetEntries to retrieve the palette colors. Then every
frame (or as often as desired) alter this array as needed, then set the new palette
by first calling IDirectDraw::WaitForVerticalBlank( DDWAITVB_BLOCKBEGIN, NULL )
to synchronize the palette change to a vertical blank, then
call IDirectDrawPalette::SetEntries.