Platform SDK: DirectX |
IDirect3DDevice7::DrawIndexedPrimitive メソッドは、頂点の配列へのインデックスに基づいて、指定されたジオメトリ プリミティブをレンダリングする。
HRESULT DrawIndexedPrimitive( D3DPRIMITIVETYPE d3dptPrimitiveType, DWORD dwVertexTypeDesc, LPVOID lpvVertices, DWORD dwVertexCount, LPWORD lpwIndices, DWORD dwIndexCount, DWORD dwFlags );
D3DPRIMITIVETYPE の D3DPT_POINTLIST メンバはインデックス付けされない。
このパラメータの使用方法は、IDirect3DDevice7::DrawPrimitive メソッドの dwVertexCount パラメータとは異なる。IDirect3DDevice7::DrawPrimitive メソッドでは、dwVertexCount パラメータは描画すべき頂点数を与えるが、このメソッドは lpvVertices パラメータが指す配列の合計頂点数を与える。IDirect3DDevice7::DrawIndexedPrimitive を呼び出すときには、dwIndexCount パラメータで描画すべき頂点数を指定する。
成功すれば D3D_OK を返す。
失敗すれば、次のいずれかの値を返す。
D3DERR_INVALIDRAMPTEXTURE |
D3DERR_INVALIDPRIMITIVETYPE |
D3DERR_INVALIDVERTEXTYPE |
DDERR_INVALIDPARAMS |
DDERR_WASSTILLDRAWING |
レンダリングする頂点が、指定した頂点フォーマットと一致していることを確認する。パフォーマンス上の理由から、Direct3D は頂点のサイズおよびストライドと提供された柔軟な頂点フォーマットとの照合を行わない。これが一致していないと、メモリ障害が発生しやすい。
このメソッドは、頂点バッファからのレンダリングには使用せず、代わりに頂点バッファ メソッドを使用する。
このメソッドは、従来のインターフェイスで使用されたメソッドとは異なり、dwFlags パラメータで D3DDP_DONOTCLIP、D3DDP_DONOTLIGHT、および D3DDP_DONOTUPDATEEXTENTS フラグを受け取らない。これらのフラグの機能性は、現在では D3DRENDERSTATE_CLIPPING、D3DRENDERSTATE_LIGHTING、および D3DRENDERSTATE_EXTENTS レンダリング ステートによって使用できる。
極端に大きな頂点配列の非常に小さな部分集合である頂点をレンダリングするのに、このメソッドを使用しないこと。このメソッドは、レンダリングする頂点の位置座標や数に関係なく、指定されたバッファのすべての頂点をトランスフォームする。したがって、数千もの頂点を格納する配列を渡して、そのうち数百の頂点しかレンダリングしないような場合は、アプリケーションのパフォーマンスが著しく低下する。大きなバッファから少数の頂点をレンダリングする必要がある場合は、Direct3D 頂点バッファ レンダリング メソッドを使用する。詳細については、「頂点バッファ」を参照すること。
このメソッドは、対応する IDirect3DDevice2 インターフェイスのものとは、第 2 パラメータとして D3DVERTEXTYPE 列挙型のメンバではなく、柔軟な頂点フォーマットの記述子を使用する点が異なる。D3DVERTEXTYPE のメンバのいずれかを使用しようとすると、このメソッドは失敗し、DDERR_INVALIDPARAMS を返す。詳細については、「頂点フォーマット」を参照すること。
DirectX の現在のバージョンでは、IDirect3DDevice7::DrawIndexedPrimitive が必要以上に大きな更新矩形を生成することがある。多数の頂点数を処理するときには、これはアプリケーションのパフォーマンスに悪影響を与える。D3DTLVERTEX 頂点を使用して、システムで必要以上の頂点を処理する場合は、D3DDP_DONOTCLIP および D3DDP_DONOTUPDATEEXTENTS フラグを使用してこの問題を解決する。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
バージョン :DirectX 7.0 が必要。
ヘッダー : d3d.h で宣言。
IDirect3DDevice7::DrawPrimitive、IDirect3DDevice7::DrawPrimitiveStrided、IDirect3DDevice7::DrawPrimitiveVB、IDirect3DDevice7::DrawIndexedPrimitiveStrided、IDirect3DDevice7::DrawIndexedPrimitiveVB