//-----------------------------------------------------------------------------
//
// Sample Name: FullScreenMode Sample
//
// Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
Description
===========
FullScreenMode demonstrates the tasks required to initialize and run
a full-screen DirectDraw application.
Path
====
Source: DXSDK\Samples\Multimedia\DDraw\FullScreenMode
Executable: DXSDK\Samples\Multimedia\DDraw\Bin
User's Guide
============
FullScreenMode requires no user input. Press the ESC key to quit the program.
Programming Notes
=================
The basic tasks to author a simple full-screen DirectDraw application are as follows:
Initialize DirectDraw:
1. Register a window class and create a window.
2. Call DirectDrawCreateEx to create a DirectDraw object
3. Call SetCooperativeLevel to set the DirectDraw cooperative level
to exclusive and full-screen.
4. Call SetDisplayMode to set the display mode, for example 640x480x8.
5. Call CreateSurface to create a flipable primary surface with 1 back buffer.
6. Call GetAttachedSurface to obtain a pointer to the back buffer.
7. If the display mode was set to palettized color, a palette is needs
to be created. This sample displays a single bitmap so it can read the
bitmap palette info to read and create a DirectDraw palette. After a palette
is created, call SetPalette to set the palette for the primary surface.
8. Create an off-screen plain DirectDraw surface, and load media content into it.
For example, this sample calls DDUtil_CreateSurfaceFromBitmap() to do just
this.
When the app is idle, and it is not hidden or minimized then render the next
frame as follows:
1. If movement or animation is involved in the app, then calculate how much
time has passed since the last time the frame was displayed.
2. Move or animate the app state based on how much time has passed.
3. Draw the current state into the backbuffer.
4. Call Flip to flip the contents of the backbuffer into the primary surface.
If the user alt-tabs away from the app, then the DirectDraw surface may be lost
(resulting in a DirectDraw call returning DDERR_SURFACELOST), then handle it by:
1. Call RestoreAllSurfaces to have DirectDraw restore all the surfaces.
2. Restoring a surface doesn't reload any content that existed in the surface
prior to it being lost. So you must now redraw the graphics the surfaces
once held. For example, this sample handles this by calling
DDUtil_ReDrawBitmapOnDDS()
LGram16
e067522598
