IDirect3DDevice9::SetViewport メソッド (d3d9.h)

デバイスのビューポートパラメータを設定します。

構文

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

[in] pViewport

設定するビューポートパラメーターを指定する、 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 を繰り返し、ビューごとにジオメトリシーケンスを描画します。