struktur D3DHAL_DP2INDEXEDLINELIST (d3dhal.h)

Artikel
02/23/2024

D3DHAL_DP2INDEXEDLINELIST diurai dari buffer perintah oleh panggilan balik D3dDrawPrimitives2 saat anggota bCommand struktur D3DHAL_DP2COMMAND diatur ke D3DDP2OP_INDEXEDLINELIST, dan digunakan untuk merender baris menggunakan indeks vertex.

Sintaks

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

Anggota

wV1

Menentukan indeks ke dalam buffer vertex, mengidentifikasi titik akhir pertama baris.

wV2

Menentukan indeks ke dalam buffer vertex, mengidentifikasi titik akhir kedua baris.

Keterangan

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

Driver harus memproses total (wPrimitiveCount * 2) simpul dari buffer puncak, dua simpul per baris. Urutan garis yang dirender adalah (wV1₀, wV2₀), (wV1₁, wV2₁), ..., (wV1n,wV2n), di mana n sama dengan (wPrimitiveCount- 1). Driver harus menginterpretasikan indeks buffer vertex berdasarkan perintah saat ini sebagai berikut:

Ketika perintah D3DDP2OP_INDEXEDLINELIST, indeks buffer vertex relatif terhadap offset buffer vertex yang ditentukan oleh anggota dwVertexOffset dari struktur D3DHAL_DRAWPRIMITIVES2DATA .
Ketika perintah D3DDP2OP_INDEXEDLINELIST2, struktur D3DHAL_DP2STARTVERTEX segera mengikutinya dan mendahului struktur D3DHAL_DP2INDEXEDLINELIST di buffer perintah. Indeks buffer vertex relatif terhadap offset buffer vertex yang ditentukan oleh dwVertexOffset ditambah offset dasar yang diperoleh dari anggota wVStart dari struktur D3DHAL_DP2STARTVERTEX.

Gambar berikut menunjukkan sebagian buffer perintah sampel yang berisi perintah D3DDP2OP_INDEXEDLINELIST dan dua struktur D3DHAL_DP2INDEXEDLINELIST. Driver harus menggambar dua baris menggunakan empat simpul berikut dari buffer puncak: (v[0], v[4]), (v[5], v[6]). Gambar memperlihatkan buffer perintah dengan perintah D3DDP2OP_INDEXEDLINELIST dan dua struktur D3DHAL_DP2INDEXEDLINELIST

Gambar memperlihatkan buffer perintah dengan perintah D3DDP2OP_INDEXEDLINELIST dan dua struktur D3DHAL_DP2INDEXEDLINELIST

Demikian pula, gambar berikut menunjukkan sebagian buffer perintah sampel yang berisi perintah D3DDP2OP_INDEXEDLINELIST2, offset D3DHAL_DP2STARTVERTEX, dan dua struktur D3DHAL_DP2INDEXEDLINELIST. Driver harus memproses empat simpul dari buffer puncak, merender dua baris yang ditentukan oleh (v[3], v[7]), (v[8], v[9]). Gambar memperlihatkan buffer perintah dengan perintah D3DDP2OP_INDEXEDLINELIST2, offset D3DHAL_DP2STARTVERTEX, dan dua struktur D3DHAL_DP2INDEXEDLINELIST