[function] IDirect3DDevice9::Clear

Clears one or more surfaces such as a render target, multiple render targets, a stencil buffer, and a depth buffer.

 

HRESULT Clear(
  [in]       DWORD    Count,
  [in] const D3DRECT  *pRects,
  [in]       DWORD    Flags,
  [in]       D3DCOLOR Color,
  [in]       float    Z,
  [in]       DWORD    Stencil
);

Parameters

Count [in]

Type: DWORD

Number of rectangles in the array at pRects. Must be set to 0 if pRects is NULL. May not be 0 if pRects is a valid pointer.

pRects [in]

Type: const D3DRECT*

Pointer to an array of D3DRECT structures that describe the rectangles to clear. Set a rectangle to the dimensions of the rendering target to clear the entire surface. Each rectangle uses screen coordinates that correspond to points on the render target. Coordinates are clipped to the bounds of the viewport rectangle. To indicate that the entire viewport rectangle is to be cleared, set this parameter to NULL and Count to 0.

Flags [in]

Type: DWORD

Combination of one or more D3DCLEAR flags that specify the surface(s) that will be cleared.

Color [in]

Type: D3DCOLOR

Clear a render target to this ARGB color.

Z [in]

Type: float

Clear the depth buffer to this new z value which ranges from 0 to 1. See remarks.

Stencil [in]

Type: DWORD

Clear the stencil buffer to this new value which ranges from 0 to 2ⁿ-1 (n is the bit depth of the stencil buffer). See remarks.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be: D3DERR_INVALIDCALL.

Remarks

Use this method to clear a surface including: a render target, all render targets in an MRT, a stencil buffer, or a depth buffer. Flags determines how many surfaces are cleared. Use pRects to clear a subset of a surface defined by an array of rectangles.

IDirect3DDevice9::Clear will fail if you:

• Try to clear either the depth buffer or the stencil buffer of a render target that does not have an attached depth buffer.
• Try to clear the stencil buffer when the depth buffer does not contain stencil data.

Requirements

Header	D3D9.h
Library	D3D9.lib

See also

IDirect3DDevice9

 

 

D3DCLEAR

These flags identify a surface to reset when calling Clear.

#define	Description
D3DCLEAR_STENCIL	Clear the stencil buffer.
D3DCLEAR_TARGET	Clear a render target, or all targets in a multiple render target. See Multiple Render Targets (Direct3D 9).
D3DCLEAR_ZBUFFER	Clear the depth buffer.

 

Constant Information

Header	d3d9types.h
Minimum operating system	Windows 98

 

Related topics

Direct3D Constants

 

 

https://msdn.microsoft.com/ko-kr/library/windows/desktop/bb174352(v=vs.85).aspx

https://msdn.microsoft.com/ko-kr/library/windows/desktop/bb172514(v=vs.85).aspx