Introduction to Presenting a Scene

The presentation application programming interfaces (APIs) are a set of methods that control the state of the device that affects what the user sees on the monitor. The set includes methods for setting display modes as well as once-per-frame methods that are used to present images to the user.

Familiarity with the following terms is necessary to understand the presentation APIs.

front buffer. A rectangle of memory that is translated by the graphics adapter and displayed on the monitor or other output device.
back buffer. A surface whose contents can be promoted to the front buffer.
swap chain. A collection of back buffers that can be serially presented to the front buffer. Typically, a full-screen swap chain presents subsequent images with the flipping device driver interface (DDI), and a windowed swap chain presents images with the blitting DDI.

Because Microsoft Direct3D for Microsoft DirectX 9.0 has one swap chain as a property of the device, there is always at least one swap chain per device. The Device class includes a set of methods that manipulate the implicit swap chain and are a copy of the swap chain's own interface. Applications can create additional swap chains; however, this is not necessary for the typical single-window or full-screen application.

The front buffer is not directly exposed in the Direct3D API for DirectX 9.0. As a result, applications cannot lock or render to the front buffer. For more information, see Accessing the Color Front Buffer.

Note: DirectX 7.0 provides a number of presentation APIs that are called together. A good example of this is the IDirectDraw7::SetCooperativeLevel, IDirectDraw7::SetDisplayMode, and IDirectDraw7::CreateSurface sequence. Additionally, the IDirectDrawSurface7::Flip and IDirectDrawSurface7::Blt methods signal the transport of rendered frames to the monitor. DirectX 9.0 collapses these groups of APIs into two main methods, Reset and Present. Reset subsumes SetCooperativeLevel, SetDisplayMode, CreateSurface, and some of the parameters to flip. Present subsumes flip and the presentation uses of blit.

A call to Manager represents an implicit reset of the device. The DirectX 9.0 API has no notion of a primary surface; it is not possible to create an object that represents the primary surface because it is considered to be an internal property of the device.

Gamma ramps are associated with a swap chain and are manipulated with the GetGammaRamp and SetGammaRamp methods.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center