Platform SDK: DirectX

Direct3DDevice7.DrawPrimitive

Direct3DDevice7.DrawPrimitive メソッドは、指定の型のジオメトリ プリミティブのシーケンスとして、頂点の指定の配列をレンダリングする。

object.DrawPrimitive( _ 
    d3Dpt As CONST_D3DPRIMITIVETYPE, _ 
    d3dfvf As CONST_D3DFVFFLAGS, _ 
    vertices As Any, _ 
    vertexCount As Long, _ 
    flags As CONST_D3DDPFLAGS)

パラメータ

object
Direct3DDevice7 オブジェクトを表すオブジェクト式。
d3Dpt
このコマンドによってレンダリングされるプリミティブの型。これは、CONST_D3DPRIMITIVETYPE 列挙の定数の 1 つでなければならない。

CONST_D3DPRIMITIVETYPE D3DPT_POINTLIST メンバには、インデックスがないことに注意する。

d3dfvf
使用する頂点フォーマットを記述する CONST_D3DFVFFLAGS 列挙の柔軟な頂点フォーマット フラグの組み合わせ。
vertices
プリミティブ シーケンスで使用する頂点配列の最初の要素。
vertexCount
頂点配列内の頂点数を定義する。許可された頂点の最大数は、65535 (&HFFFF)。
flags
プリミティブの描画方法を定義する CONST_D3DDPFLAGS 列挙の定数の 1 つ。

エラー コード

メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

D3DERR_INVALIDRAMPTEXTURE
D3DERR_INVALIDPRIMITIVETYPE
D3DERR_INVALIDVERTEXTYPE
DDERR_WASSTILLDRAWING
DDERR_INVALIDPARAMS

トラッピング エラーについては、「Visual Basic エラー トラッピング」を参照すること。

注意

頂点バッファからレンダリングする場合には、このメソッドの代わりに頂点バッファ メソッドを使用する。

レンダリングする頂点のフォーマットは、指定した頂点フォーマットと一致しなければならない。パフォーマンス上の理由から、Direct3D は、頂点のサイズとストライドが、指定された柔軟な頂点フォーマットと一致するかどうかを確認しない。これらが一致しない場合、メモリに障害が発生する可能性がある。

参照

Direct3DDevice7.DrawPrimitiveVBDirect3DDevice7.DrawIndexedPrimitiveDirect3DDevice7.DrawIndexedPrimitiveVB