Metode IDirect3DDevice9::SetPaletteEntries (d3d9helper.h)

Artikel
08/23/2023

Mengatur entri palet.

Sintaks

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

Parameter

[in] PaletteNumber

Jenis: UINT

Nilai ordinal yang mengidentifikasi palet tertentu tempat operasi akan dilakukan.

[in] pEntries

Jenis: const PALETTEENTRY*

Penunjuk ke struktur PALETTEENTRY , mewakili entri palet yang akan diatur. Jumlah struktur PALETTEENTRY yang diasumsikan oleh pEntries diasumsikan menjadi 256. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Untuk aplikasi Direct3D 9, palet apa pun yang dikirim ke metode ini harus sesuai dengan bit kemampuan D3DPTEXTURECAPS_ALPHAPALETTE dari struktur D3DCAPS9 . Jika D3DPTEXTURECAPS_ALPHAPALETTE tidak diatur, setiap entri di palet harus memiliki alfa yang diatur ke 1.0 atau metode ini akan gagal dengan D3DERR_INVALIDCALL. Jika D3DPTEXTURECAPS_ALPHAPALETTE diatur, maka set nilai alfa apa pun diizinkan. Perhatikan bahwa runtime debug akan mencetak pesan peringatan jika semua entri palet memiliki alfa yang diatur ke 0.

Palet logis tunggal dikaitkan dengan perangkat, dan dibagikan oleh semua tahap tekstur.