struktur D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)
Satu atau beberapa struktur D3DHAL_DP2TEXTURESTAGESTATE diurai dari buffer perintah oleh panggilan balik D3dDrawPrimitives2 ketika anggota bCommand struktur D3DHAL_DP2COMMAND diatur ke D3DDP2OP_TEXTURESTAGESTATE, dan digunakan untuk mengatur status tahap tekstur yang sesuai.
Sintaks
typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
WORD wStage;
WORD TSState;
DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;
Anggota
wStage
Mengidentifikasi tahap tekstur tempat memperbarui status tekstur. Anggota ini dapat menjadi bilangan bulat dalam rentang 0 hingga 7, dengan tekstur bernomor tertinggi yang paling dekat dengan buffer bingkai.
TSState
Menentukan nilai D3DTEXTURESTAGESTATETYPE yang dijumlahkan yang menentukan status tekstur yang akan diperbarui. Aplikasi DirectX 9.0 dan yang lebih baru dapat menggunakan nilai dalam enumerasi D3DSAMPLERSTATETYPE untuk mengontrol karakteristik status render terkait tekstur sampler. Di DirectX 8.0 dan yang lebih lama, status sampler ini disertakan dalam enumerasi D3DTEXTURESTAGESTATETYPE. Runtime memetakan status sampler mode pengguna (D3DSAMP_Xxx) ke nilai mode kernel D3DTSS_Xxx sehingga driver tidak diperlukan untuk memproses status sampler mode pengguna. Untuk informasi selengkapnya tentang D3DTEXTURESTAGESTATETYPE dan D3DSAMPLERSTATETYPE, lihat dokumentasi DirectX SDK.
dwValue
Menentukan nilai tempat driver harus memperbarui status tekstur yang diidentifikasi oleh TSState .
Keterangan
D3dDrawPrimitives2 harus memproses struktur D3DHAL_DP2TEXTURESTAGESTATE wStateCount dari buffer perintah. Nilai wStateCount ditentukan dalam struktur D3DHAL_DP2COMMAND.
Untuk setiap struktur D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 harus memperbarui status tekstur internal driver yang terkait dengan tekstur di dwStage untuk mencerminkan nilai baru berdasarkan TSState.
Driver yang tidak mendukung multiteksturing harus menerapkan dukungan hanya untuk tahap tekstur 0.
Gambar berikut menunjukkan sebagian buffer perintah sampel yang berisi perintah D3DDP2OP_TEXTURESTAGESTATE dan tiga struktur D3DHAL_DP2TEXTURESTAGESTATE. Driver harus memperbarui tahap nol dan tiga status tahap tekstur privatnya yang sesuai.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | d3dhal.h (termasuk D3dhal.h) |
Lihat juga
D3DDP2OP_TEXTURESTAGESTATE