Platform SDK: DirectX

線リスト

線リストとは、個々の直線の線分のリストである。線リストは、3D シーンでみぞれや大雨を表現するときなどに便利である。アプリケーションでは、頂点の配列に値を設定して線リストを作成する。線リストの頂点の数は、2 以上の偶数でなければならない。

[C++]

次のコードは、C++ でこのタスクを実行する方法を示す。

const DWORD TOTAL_VERTS=6;
D3DVERTEX lpVerts[TOTAL_VERTS];
 
lpVerts[0] = D3DVERTEX(D3DVECTOR(-5,-5,0),D3DVECTOR(0,0,-1),0,0);
lpVerts[1] = D3DVERTEX(D3DVECTOR(0,5,0),D3DVECTOR(0,0,-1),0,0);
lpVerts[2] = D3DVERTEX(D3DVECTOR(5,-5,0),D3DVECTOR(0,0,-1),0,0);
lpVerts[3] = D3DVERTEX(D3DVECTOR(10,5,0),D3DVECTOR(0,0,-1),0,0);
lpVerts[4] = D3DVERTEX(D3DVECTOR(15,-5,0),D3DVECTOR(0,0,-1),0,0);
lpVerts[5] = D3DVERTEX(D3DVECTOR(20,5,0),D3DVECTOR(0,0,-1),0,0);
 

IDirect3DDevice7::DrawPrimitive メソッドを使用して線リストをレンダリングする。次のコードは、IDirect3DDevice7::DrawPrimitive を使用して、上の例の線リストを描画する方法を示す。IDirect3DDevice7::DrawPrimitive の呼び出しは、IDirect3DDevice7::BeginSceneIDirect3DDevice7::EndScene の間で行う必要がある。

HRESULT hResult;
// このコードでは、lpDirect3DDevice が IDirect3DDevice7 インターフェイスへの
// 有効なポインタであるとする。
hResult = 
    lpDirect3DDevice->DrawPrimitive(D3DPT_LINELIST,
                                      D3DFVF_VERTEX,
                                      lpVerts,
                                      TOTAL_VERTS,
                                      D3DDP_WAIT); 
[Visual Basic]

Visual Basic アプリケーションでは、次のコードで示すように、配列に値を格納する。

' このコードでは、dx が DirectX7 オブジェクトへの
' 有効な参照であるとする。
On Local Error Resume Next
Const TOTAL_VERTS As Integer = 6
Dim Verts(TOTAL_VERTS) As D3DVERTEX
 
Verts(0) = dx.CreateD3DVertex(-5, -5, 0, 0, 0, -1, 0, 0)
Verts(1) = dx.CreateD3DVertex(0, 5, 0, 0, 0, -1, 0, 0)
Verts(2) = dx.CreateD3DVertex(5, -5, 0, 0, 0, -1, 0, 0)
Verts(3) = dx.CreateD3DVertex(10, 5, 0, 0, 0, -1, 0, 0)
Verts(4) = dx.CreateD3DVertex(15, -5, 0, 0, 0, -1, 0, 0)
Verts(5) = dx.CreateD3DVertex(20, 5, 0, 0, 0, -1, 0, 0)

Direct3DDevice7.DrawPrimitive メソッドを使用して点リストをレンダリングする。次のコードは、Direct3DDevice7.DrawPrimitive を使用して、上の例の線リストを描画する方法を示す。Direct3DDevice7.DrawPrimitive の呼び出しは、Direct3DDevice7.BeginSceneDirect3DDevice7.EndScene の間で行う必要がある。

' このコードでは、d3ddev が Direct3DDevice7 オブジェクトへの
' 有効な参照であるとする。
Call d3ddev.DrawPrimitive(D3DPT_LINELIST, _ 
D3DFVF_VERTEX, _ 
Verts(0), _ 
TOTAL_VERTS, _ 
                          D3DDP_WAIT)
 
If Err.Number <> DD_OK Then
' エラー処理コード
End If

次の図は、結果として描画される線を示す。

線リストにはマテリアルとテクスチャを適用できる。マテリアルまたはテクスチャの色は、描画された線に沿ってのみ表示され、線と線の間には表示されない。