wglRealizeLayerPalette (wingdi.h)

Artikel
08/27/2023

Fungsi wglRealizeLayerPalette memetakan entri palet dari bidang lapisan indeks warna tertentu ke palet fisik atau menginisialisasi palet bidang lapisan RGBA.

Sintaks

BOOL wglRealizeLayerPalette(
  HDC  unnamedParam1,
  int  unnamedParam2,
  BOOL unnamedParam3
);

Parameter

unnamedParam1

Menentukan konteks perangkat jendela yang palet bidang lapisannya akan direalisasikan ke dalam palet fisik.

unnamedParam2

Menentukan bidang overlay atau underlay. Nilai positif iLayerPlane mengidentifikasi bidang overlay, di mana 1 adalah bidang overlay pertama di atas bidang utama, 2 adalah bidang overlay kedua di atas bidang overlay pertama, dan sebagainya. Nilai negatif mengidentifikasi bidang underlay, di mana 1 adalah bidang underlay pertama di bawah bidang utama, 2 adalah bidang underlay kedua di bawah bidang underlay pertama, dan sebagainya. Jumlah bidang overlay dan underlay diberikan dalam anggota bReserved dari struktur PIXELFORMATDESCRIPTOR .

unnamedParam3

Menunjukkan apakah palet akan direalisasikan ke dalam palet fisik. Ketika bRealizeTRUE, entri palet dipetakan ke dalam palet fisik jika tersedia. Ketika bRealizeFALSE, entri palet untuk bidang lapisan jendela tidak lagi diperlukan dan mungkin dilepaskan untuk digunakan oleh jendela latar depan lain.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE, meskipun bRealizeTRUE dan palet fisik tidak tersedia. Jika fungsi gagal atau ketika tidak ada format piksel yang dipilih, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Palet fisik untuk bidang lapisan adalah sumber daya bersama di antara jendela dengan bidang lapisan. Ketika lebih dari satu jendela mencoba mewujudkan palet untuk bidang lapisan fisik tertentu, hanya satu palet pada satu waktu yang diwujudkan. Ketika Anda memanggil fungsi wglRealizeLayerPalette , palet lapisan jendela latar depan selalu diwujudkan terlebih dahulu.

Ketika palet lapisan jendela direalisasikan, entri paletnya selalu dipetakan satu-ke-satu ke palet fisik. Tidak seperti palet logis GDI, dengan wglRealizeLayerPalette tidak ada pemetaan palet lapisan jendela lain ke palet fisik saat ini.

Setiap kali jendela menjadi jendela latar depan, panggil wglRealizeLayerPalette untuk mewujudkan palet lapisannya lagi, bahkan jika jenis piksel bidang lapisan adalah RGBA.

Karena wglRealizeLayerPalette tidak menyadari palet bidang utama, gunakan fungsi palet GDI untuk mewujudkan palet bidang utama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll