D3DHAL_DP2INDEXEDLINESTRIP 结构 (d3dhal.h)

项目
08/07/2023

当D3DHAL_DP2COMMAND结构的bCommand 成员设置为 D3DDP2OP_INDEXEDLINESTRIP 时，D3DHAL_DP2INDEXEDLINESTRIP由 D3dDrawPrimitives2 回调从命令缓冲区进行分析，并且用于使用顶点索引呈现连接的线段序列。

语法

typedef struct _D3DHAL_DP2INDEXEDLINESTRIP {
  WORD wV[2];
} D3DHAL_DP2INDEXEDLINESTRIP, *LPD3DHAL_DP2INDEXEDLINESTRIP;

成员

wV[2]

指定顶点缓冲区中的索引，驱动程序从中获取组成线条带的顶点的坐标数据。

尽管此成员只有足够的空间来容纳两个索引，但此索引数组应被视为具有 (wPrimitiveCount+ 1) 元素的可变大小的数组。 (wPrimitiveCount 是 D3DHAL_DP2COMMAND structure.)

注解

使用顶点缓冲区呈现的索引线带是使用 D3DHAL_DP2INDEXEDLINESTRIP指定的。要处理的行段数由 D3DHAL_DP2COMMAND 的 wPrimitiveCount 成员指定。呈现的线段序列为： (wV[0]、 wV[1]) 、 (wV[1]、 wV[2]) 、 (wV[2]、 wV[3]) 、...、 (wVStart[wPrimitiveCount -1]、 wVStart[wPrimitiveCount]) 。

D3dDrawPrimitives2 应处理命令缓冲区 (wPrimitiveCount+1) 索引，实际上处理 wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP 结构。 wPrimitiveCount 的值在 D3DHAL_DP2COMMAND 结构中指定。

D3DHAL_DP2STARTVERTEX 结构紧跟在命令缓冲区中的命令后面。顶点缓冲区索引相对于由 D3DHAL_DRAWPRIMITIVES2DATA 结构的 dwVertexOffset 成员指定的顶点缓冲区偏移量加上从 D3DHAL_DP2STARTVERTEX 结构的 wVStart 成员获取的基偏移量。

下图显示了包含D3DDP2OP_INDEXEDLINESTRIP命令、D3DHAL_DP2STARTVERTEX偏移量和D3DHAL_DP2INDEXEDLINESTRIP结构列表的示例命令缓冲区的一部分。驱动程序应处理顶点缓冲区中的四个顶点，呈现由 (v[8]、v[4]) 、 (v[4]、v[7]) 、 (v[7]、v[6]) 定义的三个连接线段。