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

디바이스에 대한 뷰포트 매개 변수를 설정합니다.

구문

HRESULT SetViewport(
  [in] const D3DVIEWPORT9 *pViewport
);

[in] pViewport

형식: const D3DVIEWPORT9*

설정할 뷰포트 매개 변수를 지정하는 D3DVIEWPORT9 구조체에 대한 포인터입니다.

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 D3DERR_INVALIDCALL 반환됩니다. 이는 pViewport가 유효하지 않거나 pViewport가 렌더링 대상 표면 내에 존재할 수 없는 영역을 설명하는 경우에 발생합니다.

Direct3D는 뷰포트에 대해 다음과 같은 기본값을 설정합니다.


D3DVIEWPORT9 vp;
vp.X      = 0;
vp.Y      = 0;
vp.Width  = RenderTarget.Width;
vp.Height = RenderTarget.Height;
vp.MinZ   = 0.0f;
vp.MaxZ   = 1.0f;

IDirect3DDevice9::SetViewport 를 사용하여 화면의 일부를 그릴 수 있습니다. 뷰포트 설정이 적용되도록 기하 도형을 그리기 전에 호출해야 합니다.

장면 내에서 여러 보기를 그리려면 IDirect3DDevice9::SetViewport 를 반복하고 각 보기에 대한 기하 도형 시퀀스를 그립니다.