struktur D3DHAL_DP2CLEAR (d3dhal.h)

Artikel
02/26/2024

D3DHAL_DP2CLEAR berisi semua informasi yang dibutuhkan driver untuk melakukan pembersihan yang dibantu perangkat keras pada target penyajian, buffer kedalaman, atau buffer stensil.

Sintaks

typedef struct _D3DHAL_DP2CLEAR {
  DWORD    dwFlags;
  DWORD    dwFillColor;
  D3DVALUE dvFillDepth;
  DWORD    dwFillStencil;
  RECT     Rects[1];
} D3DHAL_DP2CLEAR;

Anggota

dwFlags

Menentukan buffer apa yang harus dihapus oleh driver. Anggota ini bisa menjadi bitwise ATAU dari nilai berikut:

Nilai	Makna
D3DCLEAR_TARGET	Driver harus menghapus target render konteks ke warna yang ditentukan oleh anggota dwFillColor.
D3DCLEAR_STENCIL	Driver harus menghapus buffer stensil konteks ke nilai yang ditentukan oleh anggota dwFillStencil.
D3DCLEAR_ZBUFFER	Driver harus menghapus buffer kedalaman konteks ke kedalaman yang ditentukan oleh anggota dwFillDepth.
D3DCLEAR_COMPUTERECTS	DirectX 8.0 dan versi yang lebih baru saja. Jika bendera ini diatur, persegi panjang yang ditentukan harus dipotong terhadap viewport saat ini. Selain itu, ada kemungkinan bahwa ketika D3DCLEAR_COMPUTERECTS ditentukan jumlah persegi panjang yang akan dihapus dapat menjadi nol (jumlah persegi panjang yang akan dihapus dapat ditemukan di penyatuan wStateCount/wPrimtiveCount dari struktur D3DHAL_DP2COMMAND untuk yang jelas). Dalam hal ini seluruh viewport harus dihapus.

dwFillColor

Menentukan warna tempat driver harus menghapus target render konteks.

dvFillDepth

Menentukan nilai yang harus digunakan driver untuk mengatur kedalaman dalam buffer kedalaman konteks. Anggota ini bisa menjadi nilai dalam interval 0,0 hingga 1,0. Driver harus mengonversi nilai ini menjadi bilangan bulat menggunakan anggota dwZBitMask dari struktur DDPIXELFORMAT buffer kedalaman.

dwFillStencil

Menentukan nilai tempat driver harus menghapus buffer stensil konteks. Anggota ini bisa menjadi bilangan bulat dalam interval 0 hingga 2ⁿ-1, di mana n adalah jumlah bit dalam buffer stensil.

Rects[1]

Menentukan area persegi panjang buffer yang harus dibersihkan oleh driver. Persegi panjang ditentukan dalam koordinat layar. Anggota struktur ini berisi area persegi panjang pertama yang akan di blitted. Anggota wStateCountdari D3DHAL_DP2COMMAND berisi jumlah total area persegi panjang yang akan dijadikan blitted. Struktur RECT lainnya (wStateCount-1) yang diperlukan mengikuti struktur D3DHAL_DP2CLEAR tanpa padding apa pun.

Keterangan

Struktur ini digunakan dengan token perintah D3DDP2OP_CLEAR untuk menggantikan panggilan balik D3dClear dan D3dClear2 warisan.

Penting untuk dicatat bahwa ketika jumlah persegi panjang adalah nol, struktur data D3DHAL_DP2CLEAR masih mencakup ruang untuk satu RECT. Dengan demikian, ukuran RECT tunggal ini harus disertakan saat maju ke instruksi DP2 berikutnya. Namun, konten RECT dalam hal ini tidak terdefinisi dan driver tidak boleh mencoba membacanya.

Driver tampilan harus mengonversi nilai warna input untuk kelas ARGB dan YUV dari format warna. Untuk operasi yang jelas, nilai warna input ditentukan dalam anggota dwFillColor . Untuk informasi selengkapnya, lihat Menangani Nilai Warna untuk Format Piksel.

Persyaratan

Persyaratan	Nilai
Header	d3dhal.h (termasuk D3dhal.h)

Lihat juga

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT

Bagikan melalui