IDirect3DDevice9::D rawIndexedPrimitive メソッド (d3d9helper.h)

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

インデックス作成に基づいて、指定したジオメトリックプリミティブを頂点の配列にレンダリングします。

構文

HRESULT DrawIndexedPrimitive(
  [in] D3DPRIMITIVETYPE unnamedParam1,
  [in] INT              BaseVertexIndex,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             startIndex,
  [in] UINT             primCount
);

パラメーター

[in] unnamedParam1

種類: D3DPRIMITIVETYPE

D3DPRIMITIVETYPE列挙型のメンバー。レンダリングするプリミティブの型を記述します。 D3DPT_POINTLISTは、このメソッドではサポートされていません。「解説」を参照してください。

[in] BaseVertexIndex

型: INT

頂点バッファーの先頭から最初の頂点へのオフセット。「シナリオ 4」を参照してください。

[in] MinVertexIndex

型: UINT

この呼び出し中に使用される頂点の最小頂点インデックス。これは、BaseVertexIndex に対する 0 から始まるインデックスです。

[in] NumVertices

型: UINT

この呼び出し中に使用される頂点の数。最初の頂点は、インデックス (BaseVertexIndex + MinIndex) にあります。

[in] startIndex

型: UINT

頂点バッファーにアクセスするときに使用する最初のインデックスのインデックス。 StartIndex から頂点バッファーから頂点のインデックスを作成します。

[in] primCount

型: UINT

レンダリングするプリミティブの数。使用される頂点の数は、プリミティブ数とプリミティブ型の関数です。許可されるプリミティブの最大数は、 D3DCAPS9 構造体の MaxPrimitiveCount メンバーを確認することによって決定されます。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

注釈

このメソッドは、現在のデータ入力ストリームのセットからインデックス付きプリミティブを描画します。 MinIndex とインデックスストリーム内のすべてのインデックスは、BaseVertexIndex に対して相対的です。

MinIndex パラメーターと NumVertices パラメーターは、 IDirect3DDevice9::D rawIndexedPrimitive 呼び出しごとに使用される頂点インデックスの範囲を指定します。これらは、これらの頂点にインデックスを作成する前に、連続した範囲の頂点を処理することによって、インデックス付きプリミティブの頂点処理を最適化するために使用されます。この呼び出し中に使用されるインデックスで、この範囲外の頂点を参照することは無効です。

インデックス配列が設定されていない場合、IDirect3DDevice9::D rawIndexedPrimitive は失敗します。

D3DPRIMITIVETYPE列挙型の D3DPT_POINTLIST メンバーはサポートされておらず、このメソッドの有効な型ではありません。

レガシアプリケーションを Direct3D 9 に変換する場合は、固定関数パイプラインを使用するために IDirect3DDevice9::SetFVF に呼び出しを追加するか、または IDirect3DDevice9::SetVertexDeclaration を使用して頂点シェーダーを使用してから Draw 呼び出しを行う必要があります。