Share via

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
YUV 또는 YCbBr 형식의 비디오 보기의 경우 ClearView 는 색 값을 변환하지 않습니다. 서식 이름이 _UNORM, _UINT 등을 나타내지 않는 경우 ClearView 는 _UINT 가정합니다. 따라서 235.0f는 235에 매핑됩니다(0으로 반올림하고 범위를 벗어난/INF 값은 대상 범위에 클램프하고 NaN은 0으로 반올림).

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d3d11_1.h
라이브러리 D3D11.lib

추가 정보

ID3D11DeviceContext1