Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

You can think of DirectDraw as being composed of several objects that work together. This topic describes the objects you use when working with DirectDraw, organized by object type. For detailed information, see Working with DirectDraw Objects.

The following table shows the objects used by DirectDraw.

Object Description

DirectDraw

The DirectDraw object is the heart of all DirectDraw applications. It is the first object you create, and you use it to make all other related objects.

You create a DirectDraw object by calling the DirectDrawCreatefunction. DirectDraw objects expose their functionality through the IDirectDrawinterface.

For more information, see Working with DirectDraw Objects.

DirectDrawClipper

The DirectDrawClipper object (casually referred to as a clipper) helps you prevent blitting to certain portions of a surface or beyond the bounds of a surface.

You can create a clipper by calling the IDirectDraw::CreateClippermethod.

DirectDrawClipper objects expose their functionality through the IDirectDrawClipperinterface.

For more information, see Working with DirectDraw Clippers.

DirectDrawColorControl

The DirectDrawColorControl object allows you to get and set color controls. This object is accessed through the IDirectDrawColorControlinterface.

DirectDrawSurface

The DirectDrawSurface object (casually referred to as a surface) represents an area in memory that holds data to be displayed on the monitor as images or moved to other surfaces. You usually create a surface by calling the IDirectDraw::CreateSurfacemethod of the DirectDraw object with which it will be associated. DirectDrawSurface objects expose their functionality through the IDirectDrawSurfaceinterface. For more information, see Working with DirectDraw Surfaces.