D3DHAL_DP2TRIANGLEFAN_IMM Struktur (d3dhal.h)

Eine D3DHAL_DP2TRIANGLEFAN_IMM Struktur wird vom D3dDrawPrimitives2-Rückruf aus dem Befehlspuffer analysiert, wenn der bCommand-Member der D3DHAL_DP2COMMAND-Struktur auf D3DDP2OP_TRIANGLEFAN_IMM festgelegt ist und zum Rendern eines Dreiecklüers verwendet wird.

Syntax

typedef struct _D3DHAL_DP2TRIANGLEFAN_IMM {
  DWORD dwEdgeFlags;
} D3DHAL_DP2TRIANGLEFAN_IMM;

Member

dwEdgeFlags

Gibt eine Bitmaske an, die angibt, welche der äußeren Kanten des Lüfters gerendert werden sollen, wenn der Füllmodus D3DFILL_WIREFRAME ist. Ein festgelegtes Bit gibt an, dass die entsprechende Kante gerendert werden soll. Weitere Informationen zu dieser Bitmaske finden Sie im Abschnitt Hinweise.

Hinweise

Eine D3DHAL_DP2TRIANGLEFAN_IMM-Struktur folgt unmittelbar der D3DHAL_DP2COMMAND-Struktur im Befehlspuffer. Die Vertexdaten des Dreiecklügefächers werden direkt nach der D3DHAL_DP2TRIANGLEFAN_IMM-Struktur im Befehlspuffer DWORD ausgerichtet.

D3dDrawPrimitives2 sollte insgesamt wPrimitiveCount+2 Scheitelpunkte aus dem Befehlspuffer, drei Scheitelpunkte pro Dreieck verarbeiten und wPrimitiveCount-Dreiecke rendern. Die Sequenz der gerenderten Dreiecke ist (V[1], V[2], V[0]), (V[2], V[3], V[0]), (V[3], V[4], V[0]), ..., (V[wPrimitiveCount], V[wPrimitiveCount] + 1], V[0]). Der Wert von wPrimitiveCount wird in der D3DHAL_DP2COMMAND-Struktur angegeben.

Der Treiber muss die Randflagge für die äußeren Kanten des Lüfters überprüfen, wenn der Füllmodus D3DFILL_WIREFRAME ist. Ausgehend vom geringsten Anteil an dwEdgeFlags, Bit 0 gilt für den V[0]-V[1] -Edge, Bit 1 gilt für den V[1]-V[2] Edge, ..., Bit wPrimitiveCount gilt für den V[wPrimitiveCount]-V[[[wPrimitiveCount]+1] Edge, und bit (wPrimitiveCount + 1) gilt für V[[wPrimitiveCount]+1]-V[0] Rand.

Die folgende Abbildung zeigt einen Teil eines Beispielbefehlspuffers, der einen D3DDP2OP_TRIANGLEFAN_IMM-Befehl, eine D3DHAL_DP2TRIANGLEFAN_IMM-Struktur und die Vertexdaten enthält. Der Treiber sollte die fünf Scheitelpunkte aus dem Befehlspuffer verarbeiten und dabei einen Lüfter mit drei Dreiecken rendern, die durch (v[1], v[2], v[0]), (v[2], v[3], v[0]), (v[3], v[4], v[0]) definiert sind.

Anforderungen

Anforderung	Wert
Header	d3dhal.h (include D3dhal.h)

Weitere Informationen

D3DDP2OP_TRIANGLEFAN_IMM

D3DHAL_DP2COMMAND

D3dDrawPrimitives2