다음을 통해 공유


IDirect3DDevice9::Clear 메서드(d3d9helper.h)

렌더링 대상, 여러 렌더링 대상, 스텐실 버퍼 및 깊이 버퍼와 같은 하나 이상의 표면을 지웁니다.

구문

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

매개 변수

[in] Count

형식: DWORD

pRect에서 배열의 사각형 수입니다. pRect가 NULL인 경우 0으로 설정해야 합니다. pRect가 유효한 포인터인 경우 0이 아닐 수 있습니다.

[in] pRects

형식: const D3DRECT*

지울 사각형을 설명하는 D3DRECT 구조체의 배열에 대한 포인터입니다. 렌더링 대상의 크기로 사각형을 설정하여 전체 표면을 지웁니다. 각 사각형은 렌더링 대상의 지점에 해당하는 화면 좌표를 사용합니다. 좌표는 뷰포트 사각형의 범위로 잘립니다. 전체 뷰포트 사각형을 지워야 함을 나타내려면 이 매개 변수를 NULL 로 설정하고 Count를 0으로 설정합니다.

[in] Flags

형식: DWORD

지울 표면을 지정하는 하나 이상의 D3DCLEAR 플래그 조합입니다.

[in] Color

형식: D3DCOLOR

이 ARGB 색에 대한 렌더링 대상의 지우기

[in] Z

형식: float

깊이 버퍼를 0에서 1 사이의 새 z 값으로 지웁니다. 설명을 참조하세요.

[in] Stencil

형식: DWORD

스텐실 버퍼를 0에서 2-1 사이인 이 새 값으로 지웁니다(n은 스텐실 버퍼의 비트 깊이임). 설명을 참조하세요.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL 수 있습니다.

설명

렌더링 대상, MRT의 모든 렌더링 대상, 스텐실 버퍼 또는 깊이 버퍼 등 표면을 지우려면 이 메서드를 사용합니다. 플래그는 지워지는 표면 수를 결정합니다. pRect를 사용하여 사각형 배열로 정의된 표면의 하위 집합을 지웁니다.

다음과 같은 경우 IDirect3DDevice9::Clear가 실패합니다.

  • 깊이 버퍼가 연결되어 있지 않은 렌더링 대상의 깊이 버퍼 또는 스텐실 버퍼를 지웁니다.
  • 깊이 버퍼에 스텐실 데이터가 포함되지 않은 경우 스텐실 버퍼를 지웁니다.

요구 사항

   
대상 플랫폼 Windows
헤더 d3d9helper.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DDevice9