D3DHAL_DP2INDEXEDLINESTRIP 構造体 (d3dhal.h)

[アーティクル]
02/26/2024

D3DHAL_DP2INDEXEDLINESTRIPは、D3DHAL_DP2COMMAND構造体のbCommand メンバーが D3DDP2OP_INDEXEDLINESTRIP に設定されている場合、D3dDrawPrimitives2 コールバックによってコマンドバッファーから解析され、頂点インデックスを使用して一連の接続された線分をレンダリングするために使用されます。

構文

typedef struct _D3DHAL_DP2INDEXEDLINESTRIP {
  WORD wV[2];
} D3DHAL_DP2INDEXEDLINESTRIP, *LPD3DHAL_DP2INDEXEDLINESTRIP;

メンバー

wV[2]

ドライバーがラインストリップを構成する頂点の座標データを取得する頂点バッファーへのインデックスを指定します。

このメンバーには 2 つのインデックスを保持するのに十分な領域しかありませんが、このインデックスの配列は、(wPrimitiveCount+ 1) 要素を持つ可変サイズの配列として扱う必要があります。 (wPrimitiveCount は、D3DHAL_DP2COMMAND構造体のメンバーです)。

注釈

頂点バッファーでレンダリングされるインデックス付きラインストリップは、D3DHAL_DP2INDEXEDLINESTRIPを使用して指定されます。処理する線分の数は、D3DHAL_DP2COMMANDの wPrimitiveCount メンバーによって指定されます。レンダリングされる一連の線分は次のとおりです(wV[0], wV[1]), (wV[1], wV[2]), (wV[2], wV[3]), ..., (wVStart[wPrimitiveCount -1], wVStart[wPrimitiveCount])。

D3dDrawPrimitives2 では、コマンドバッファーから (wPrimitiveCount+1) インデックスを処理し、実際には wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP構造体を処理する必要があります。 wPrimitiveCount の値は、D3DHAL_DP2COMMAND構造体で指定されます。

D3DHAL_DP2STARTVERTEX構造体は、コマンドバッファー内のコマンドの直後にあります。頂点バッファーインデックスは、D3DHAL_DRAWPRIMITIVES2DATA 構造体の dwVertexOffset メンバーによって指定された頂点バッファーオフセットと、D3DHAL_DP2STARTVERTEX 構造体の wVStart メンバーから取得されたベースオフセットに対する相対位置です。

次の図は、D3DDP2OP_INDEXEDLINESTRIP コマンド、D3DHAL_DP2STARTVERTEX オフセット、およびD3DHAL_DP2INDEXEDLINESTRIP構造体の一覧を含むサンプルコマンドバッファーの一部を示しています。ドライバーは頂点バッファーから 4 つの頂点を処理し、(v[8], v[4]), (v[4], v[7]), (v[7], v[6]) で定義された 3 つの接続された線分をレンダリングする必要があります。