struktur D3DHAL_DP2INDEXEDTRIANGLEFAN (d3dhal.h)

Artikel
02/26/2024

D3DHAL_DP2INDEXEDTRIANGLEFAN diurai dari buffer perintah oleh panggilan balik D3dDrawPrimitives2 ketika anggota bCommand struktur D3DHAL_DP2COMMAND diatur ke D3DDP2OP_INDEXEDTRIANGLEFAN, dan digunakan untuk merender urutan segitiga yang terhubung menggunakan indeks vertex. Semua segitiga berbagi puncak umum.

Sintaks

typedef struct _D3DHAL_DP2INDEXEDTRIANGLEFAN {
  WORD wV[3];
} D3DHAL_DP2INDEXEDTRIANGLEFAN, *LPD3DHAL_DP2INDEXEDTRIANGLEFAN;

Anggota

wV[3]

Menentukan indeks ke dalam buffer puncak tempat driver mendapatkan data koordinat untuk simpul yang membentuk kipas segitiga.

Meskipun anggota ini hanya memiliki cukup ruang untuk berisi tiga indeks, array indeks ini harus diperlakukan sebagai array berukuran variabel dengan elemen (wPrimitiveCount + 2). (wPrimitiveCount adalah anggota struktur D3DHAL_DP2COMMAND.)

Keterangan

D3dDrawPrimitives2 harus memproses indeks (wPrimitiveCount+2) dari buffer perintah, yang berlaku, memproses struktur D3DHAL_DP2INDEXEDTRIANGLEFAN wPrimitiveCount . Nilai wPrimitiveCount ditentukan dalam struktur D3DHAL_DP2COMMAND.

Driver harus memproses total (wPrimitiveCount + 2) simpul dari buffer vertex, tiga simpul per segitiga. Urutan segitiga yang dirender adalah: (wV[1], wV[2], wV[0]), (wV[2], wV[3], wV[0]), (wV[3], wV[4], wV[0]), ..., (wV[wPrimitiveCount], wV[wPrimitiveCount]+1], wV[0]). Perhatikan bahwa semua segitiga memiliki puncak yang ditentukan dalam wV[0].

Struktur D3DHAL_DP2STARTVERTEX segera mengikuti perintah di buffer perintah. Indeks buffer vertex relatif terhadap offset buffer vertex yang ditentukan oleh anggota dwVertexOffset dari struktur D3DHAL_DRAWPRIMITIVES2DATA ditambah offset dasar yang diperoleh dari anggota wVStart dari struktur D3DHAL_DP2STARTVERTEX.

Gambar berikut menunjukkan sebagian buffer perintah sampel yang berisi perintah D3DDP2OP_INDEXEDTRIANGLEFAN, offset D3DHAL_DP2STARTVERTEX, dan daftar logis struktur D3DHAL_DP2INDEXEDTRIANGLEFAN. Driver harus memproses lima simpul dari buffer puncak, merender kipas dengan tiga segitiga yang ditentukan oleh (v[4], v[5], v[7]), (v[5], v[6], v[7]), (v[6], v[9], v[7]).