D3DHAL_DP2INDEXEDLINESTRIP Struktur (d3dhal.h)

Artikel
02/23/2024

D3DHAL_DP2INDEXEDLINESTRIP vom D3dDrawPrimitives2-Rückruf aus dem Befehlspuffer analysiert wird, wenn das bCommand-Element der D3DHAL_DP2COMMAND-Struktur auf D3DDP2OP_INDEXEDLINESTRIP festgelegt ist, und wird verwendet, um eine Sequenz verbundener Zeilensegmente mithilfe von Vertexindizes zu rendern.

Syntax

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

Member

wV[2]

Gibt die Indizes im Scheitelpunktpuffer an, aus denen der Treiber Koordinatendaten für die Scheitelpunkte des Zeilenstreifens abruft.

Obwohl dieses Element nur genügend Platz für zwei Indizes hat, sollte dieses Array von Indizes als Array mit variablen Größen mit (wPrimitiveCount+ 1) -Elementen behandelt werden. (wPrimitiveCount ist ein Element der D3DHAL_DP2COMMAND-Struktur.)

Hinweise

Mit Vertexpuffern gerenderte indizierte Zeilenstreifen werden mithilfe von D3DHAL_DP2INDEXEDLINESTRIP angegeben. Die Anzahl der zu verarbeitenden Zeilensegmente wird vom wPrimitiveCount-Member von D3DHAL_DP2COMMAND angegeben. Die Sequenz der gerenderten Zeilensegmente ist: (wV[0], wV[1]), (wV[1], wV[2],wV[3]), ..., (wVStart[wPrimitiveCount -1], wVStart[wPrimitiveCount]).

D3dDrawPrimitives2 sollte Indizes (wPrimitiveCount+1) aus dem Befehlspuffer verarbeiten, wobei die Verarbeitung von wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP Strukturen erfolgt. Der Wert von wPrimitiveCount wird in der D3DHAL_DP2COMMAND-Struktur angegeben.

Eine D3DHAL_DP2STARTVERTEX-Struktur folgt sofort dem Befehl im Befehlspuffer. Die Vertexpufferindizes sind relativ zum Vertexpufferoffset, der vom dwVertexOffset-Element der D3DHAL_DRAWPRIMITIVES2DATA-Struktur und dem Basisoffset angegeben wird, der vom wVStart-Member der D3DHAL_DP2STARTVERTEX-Struktur abgerufen wird.

Die folgende Abbildung zeigt einen Teil eines Beispielbefehlspuffers, der einen D3DDP2OP_INDEXEDLINESTRIP-Befehl, einen D3DHAL_DP2STARTVERTEX Offset und eine Liste D3DHAL_DP2INDEXEDLINESTRIP Strukturen enthält. Der Treiber sollte vier Scheitelpunkte aus dem Vertexpuffer verarbeiten und dabei drei verbundene Liniensegmente rendern, die durch (v[8], v[4]), (v[4], v[7]), (v[7], v[6]) definiert sind.