IDirect3DDevice9::SetViewport メソッド (d3d9helper.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 を繰り返し、ビューごとにジオメトリシーケンスを描画します。