D3DHAL_DP2INDEXEDLINELIST結構（d3dhal.h）

2025-02-06

D3DHAL_DP2INDEXEDLINELIST 當 D3DHAL_DP2COMMAND 結構的 bCommand 成員設定為 D3DDP2OP_INDEXEDLINELIST 時，D3dDrawPrimitives2 會從命令緩衝區剖析，並使用頂點索引來轉譯線條。

語法

typedef struct _D3DHAL_DP2INDEXEDLINELIST {
  WORD wV1;
  WORD wV2;
} D3DHAL_DP2INDEXEDLINELIST, *LPD3DHAL_DP2INDEXEDLINELIST;

成員

wV1

指定頂點緩衝區中的索引，識別該行的第一個端點。

wV2

指定頂點緩衝區中的索引，以識別該行的第二個端點。

言論

D3dDrawPrimitives2 應該從命令緩衝區處理（wPrimitiveCount * 2）索引，實際上處理 wPrimitiveCount D3DHAL_DP2INDEXEDLINELIST 結構。 wPrimitiveCount 的值是在 D3DHAL_DP2COMMAND 結構中指定。

驅動程式應該從頂點緩衝區處理總計（wPrimitiveCount * 2）頂點，每行兩個頂點。轉譯的行序列為（wV1₀， wV2₀），（wV1₁， wV2₁）,..., ..., （wV1n，wV2n），其中 n 等於（wPrimitiveCount- 1）。驅動程式應該根據目前的命令來解譯頂點緩衝區索引，如下所示：

當命令D3DDP2OP_INDEXEDLINELIST時，頂點緩衝區索引會相對於 dwVertexOffset 所指定的頂點緩衝區位移，D3DHAL_DRAWPRIMITIVES2DATA 結構的成員。
當命令D3DDP2OP_INDEXEDLINELIST2時，D3DHAL_DP2STARTVERTEX 結構會緊接在命令緩衝區中的D3DHAL_DP2INDEXEDLINELIST結構之前。頂點緩衝區索引相對於 dwVertexOffset 所指定的頂點緩衝區位移 加上從 D3DHAL_DP2STARTVERTEX 結構 wVStart 成員取得的基底位移。

下圖顯示範例命令緩衝區的一部分，其中包含D3DDP2OP_INDEXEDLINELIST命令和兩個D3DHAL_DP2INDEXEDLINELIST結構。驅動程序應該使用下列四個頂點從頂點緩衝區繪製兩行：（v[0]，v[4]），（v[5]，v[6]）。圖顯示具有D3DDP2OP_INDEXEDLINELIST命令和兩個D3DHAL_DP2INDEXEDLINELIST結構

圖顯示具有D3DDP2OP_INDEXEDLINELIST命令和兩個D3DHAL_DP2INDEXEDLINELIST結構

類似的命令緩衝區，下圖顯示包含D3DDP2OP_INDEXEDLINELIST2命令、D3DHAL_DP2STARTVERTEX位移和兩個D3DHAL_DP2INDEXEDLINELIST結構的範例命令緩衝區部分。驅動程式應該從頂點緩衝區處理四個頂點，轉譯由（v[3]， v[7]），（v[8]， v[9] 定義的兩行。圖顯示具有D3DDP2OP_INDEXEDLINELIST2命令的命令緩衝區、D3DHAL_DP2STARTVERTEX位移，以及兩個D3DHAL_DP2INDEXEDLINELIST結構