ID3D11DeviceContext1::ClearView 메서드(d3d11_1.h)
리소스 뷰의 모든 요소를 하나의 값으로 설정합니다.
구문
void ClearView(
[in] ID3D11View *pView,
[in] const FLOAT [4] Color,
[in, optional] const D3D11_RECT *pRect,
UINT NumRects
);
매개 변수
[in] pView
지울 리소스 뷰를 나타내는 ID3D11View 인터페이스에 대한 포인터입니다.
[in] Color
리소스 뷰를 지우는 데 사용할 색을 나타내는 4개 구성 요소 배열입니다.
[in, optional] pRect
지울 리소스 뷰의 사각형에 대한 D3D11_RECT 구조체의 배열입니다. NULL인 경우 ClearView는 전체 표면을 지웁니다.
NumRects
pRect 매개 변수가 지정하는 배열의 사각형 수입니다.
반환 값
없음
설명
ClearView 는 깊이 전용 리소스(스텐실 구성 요소가 없는 리소스), UAV(순서가 지정되지 않은 액세스 보기) 또는 Texture2D 표면의 비디오 보기에서 RTV(렌더링 대상 뷰), DSV(깊이/스텐실 뷰)에서만 작동합니다. 런타임이 잘못된 호출을 삭제합니다. pRect 배열의 빈 사각형은 no-op입니다. 위쪽 값이 아래쪽 값과 같거나 왼쪽 값이 오른쪽 값과 같으면 사각형이 비어 있습니다.
ClearView 는 3D 텍스처를 지원하지 않습니다.
ClearView 는 보기의 모든 배열 조각에 동일한 색 값을 적용합니다. pRect 배열의 모든 사각형은 각 배열 조각에 해당합니다. 사각형의 pRect 배열은 단일 표면에서 지울 영역 집합입니다. 보기가 배열인 경우 ClearView 는 각 배열 조각의 모든 사각형을 개별적으로 지웁니다.
버퍼에 사각형을 적용할 때 맨 위 값을 0으로 설정하고 아래쪽 값을 1로 설정하고 왼쪽 값과 오른쪽 값을 설정하여 버퍼 내의 범위를 설명합니다. 위쪽 값이 아래쪽 값과 같거나 왼쪽 값이 오른쪽 값과 같으면 사각형이 비어 있고 no-op이 달성됩니다.
드라이버는 Direct3D 변환 규칙에 따라 색상 값을 대상 형식으로 변환하고 고정합니다. 예를 들어 보기 형식이 DXGI_FORMAT_R8G8B8A8_UNORM 경우 드라이버는 입력을 0.0f에서 1.0f(+INF -> 1.0f(0XFF)/NaN -> 0.0f)로 고정합니다.
형식이 정수( 예: DXGI_FORMAT_R8G8B8A8_UINT)인 경우 런타임은 입력을 정수 부동 소수점수로 해석합니다. 따라서 235.0f는 235에 매핑됩니다(0으로 반올림하고 범위를 벗어난/INF 값은 대상 범위에 클램프하고 NaN은 0으로 반올림).
색 매핑은 다음과 같습니다.
- Color[0]: R(또는 비디오의 경우 Y)
- Color[1]: G(또는 비디오의 경우 U/Cb)
- Color[2]: B(또는 비디오의 경우 V/Cr)
- Color[3]: A
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | d3d11_1.h |
| 라이브러리 | D3D11.lib |