Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ClearRenderTargetView
End
Map
Collapse the table of content
Expand the table of content

ID3D11DeviceContext::ClearRenderTargetView method

Set all the elements in a render target to one value.

Syntax


void ClearRenderTargetView(
  [in]       ID3D11RenderTargetView *pRenderTargetView,
  [inconst FLOAT                  ColorRGBA[4]
);

Parameters

pRenderTargetView [in]

Type: ID3D11RenderTargetView*

Pointer to the render target.

ColorRGBA [in]

Type: const FLOAT[4]

A 4-component array that represents the color to fill the render target with.

Return value

Returns nothing.

Remarks

Applications that wish to clear a render target to a specific integer value bit pattern should render a screen-aligned quad instead of using this method. The reason for this is because this method accepts as input a floating point value, which may not have the same bit pattern as the original integer.

Differences between Direct3D 9 and Direct3D 11/10:

Unlike Direct3D 9, the full extent of the resource view is always cleared. Viewport and scissor settings are not applied.

 

When using D3D_FEATURE_LEVEL_9_x, ClearRenderTargetView only clears the first array slice in the render target view. This can impact (for example) cube map rendering scenarios. Applications should create a render target view for each face or array slice, then clear each view individually.

Windows Phone 8: This API is supported.

Requirements

Header

D3D11.h

Library

D3D11.lib

See also

ID3D11DeviceContext

 

 

Community Additions

ADD
Show:
© 2015 Microsoft