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 |