D3DVIEWPORT9 構造体

  • [アーティクル]

3D ボリュームが投影されるレンダー ターゲット サーフェスのウィンドウ 寸法を定義します。

構文

typedef struct D3DVIEWPORT9 {
  DWORD X;
  DWORD Y;
  DWORD Width;
  DWORD Height;
  float MinZ;
  float MaxZ;
} D3DVIEWPORT9, *LPD3DVIEWPORT9;

メンバー

X

型: DWORD

レンダー ターゲット サーフェス上のビューポートの左上隅のピクセル座標。 サーフェスのサブセットにレンダリングする場合を除き、このメンバーは 0 に設定できます。

Y

型: DWORD

レンダー ターゲット サーフェス上のビューポートの左上隅のピクセル座標。 サーフェスのサブセットにレンダリングする場合を除き、このメンバーは 0 に設定できます。

Width

型: DWORD

クリップ ボリュームの幅の寸法 (ピクセル単位)。 サーフェスのサブセットにのみレンダリングする場合を除き、このメンバーはレンダー ターゲット サーフェスの幅寸法に設定する必要があります。

Height

型: DWORD

クリップ ボリュームの高さ寸法 (ピクセル単位)。 サーフェスのサブセットにのみレンダリングする場合を除き、このメンバーはレンダー ターゲット サーフェスの高さ寸法に設定する必要があります。

Minz

型: float

MaxZ と共に、シーンをレンダリングする深度値の範囲、クリップ ボリュームの最小値と最大値を示す値。 ほとんどのアプリケーションでは、この値を 0.0 に設定します。 クリッピングは、投影行列を適用した後に実行されます。

MaxZ

型: float

MinZ と共に、シーンをレンダリングする深度値の範囲、クリップ ボリュームの最小値と最大値を示す値。 ほとんどのアプリケーションでは、この値を 1.0 に設定します。 クリッピングは、投影行列を適用した後に実行されます。

解説

X、Y、Width、Height の各メンバーは、レンダー ターゲット サーフェス上のビューポートの位置と寸法を記述します。 通常、アプリケーションはターゲット サーフェス全体にレンダリングされます。640 x 480 サーフェスでレンダリングする場合、これらのメンバーはそれぞれ 0、0、640、および 480 である必要があります。 MinZ と MaxZ は通常、0.0 と 1.0 に設定されますが、特定の効果を実現するために他の値に設定できます。 たとえば、両方を 0.0 に設定して、オブジェクトをシーンの前景に強制的にレンダリングし、両方を 1.0 に設定してオブジェクトを強制的にバックグラウンドに入れたとします。

( SetViewport メソッドの呼び出しにより) デバイスのビューポート パラメーターが変更されると、ドライバーは新しい変換マトリックスをビルドします。

要件

要件 値
ヘッダー
D3D9Types.h

関連項目

Direct3D 構造体

GetViewport

SetViewport