fungsi wglSwapLayerBuffers (wingdi.h)

Artikel
08/27/2023

Fungsi wglSwapLayerBuffers menukar buffer depan dan belakang di overlay, underlay, dan bidang utama jendela yang dirujuk oleh konteks perangkat tertentu.

Sintaks

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Parameter

unnamedParam1

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

unnamedParam2

Menentukan overlay, underlay, dan bidang utama yang buffer depan dan belakangnya akan ditukar. Anggota bReserved dari struktur PIXELFORMATDESCRIPTOR menentukan jumlah bidang overlay dan underlay. Parameter fuPlanes adalah kombinasi bitwise dari nilai berikut.

Nilai	Makna
WGL_SWAP_MAIN_PLANE	Tukar buffer depan dan belakang dari pesawat utama.
WGL_SWAP_OVERLAYi	Tukar buffer depan dan belakang bidang overlay i, di mana i adalah bilangan bulat antara 1 dan 15. WGL_SWAP_OVERLAY1 mengidentifikasi bidang overlay pertama di atas bidang utama, WGL_SWAP_OVERLAY2 mengidentifikasi bidang overlay kedua di atas bidang overlay pertama, dan sebagainya.
WGL_SWAP_UNDERLAYi	Tukar buffer depan dan belakang bidang bawah i, di mana saya adalah bilangan bulat antara 1 dan 15. WGL_SWAP_UNDERLAY1 mengidentifikasi bidang underlay pertama di bawah bidang utama, WGL_SWAP_UNDERLAY2 mengidentifikasi bidang underlay kedua di bawah bidang underlay pertama, dan sebagainya.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE. Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Ketika bidang lapisan tidak menyertakan buffer belakang, memanggil fungsi wglSwapLayerBuffers tidak berpengaruh pada bidang lapisan tersebut. Setelah Anda memanggil wglSwapLayerBuffers, status konten buffer belakang diberikan dalam struktur LAYERPLANEDESCRIPTOR yang sesuai dari bidang lapisan atau dalam struktur PIXELFORMATDESCRIPTOR dari bidang utama. Fungsi wglSwapLayerBuffers menukar buffer depan dan belakang di bidang lapisan yang ditentukan secara bersamaan.

Beberapa perangkat tidak mendukung pertukaran bidang lapisan satu per satu; mereka menukar semua bidang lapisan sebagai grup. Ketika bendera PFD_SWAP_LAYER_BUFFERS struktur PIXELFORMATDESCRIPTOR diatur, itu menunjukkan bahwa perangkat dapat menukar bidang lapisan individual dan bahwa Anda dapat memanggil wglSwapLayerBuffers.

Dengan aplikasi yang menggunakan beberapa utas, sebelum memanggil wglSwapLayerBuffers, hapus semua perintah gambar di semua utas yang menggambar ke jendela yang sama.

Persyaratan


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

Lihat juga

LAYERPLANEDESCRIPTOR

OpenGL di Windows

PIXELFORMATDESCRIPTOR

SwapBuffers

Fungsi WGL

Bagikan melalui