fungsi wglCreateLayerContext (wingdi.h)

Artikel
08/27/2023

Fungsi wglCreateLayerContext membuat konteks penyajian OpenGL baru untuk menggambar ke bidang lapisan tertentu pada konteks perangkat.

Sintaks

HGLRC wglCreateLayerContext(
  HDC unnamedParam1,
  int unnamedParam2
);

Parameter

unnamedParam1

Menentukan konteks perangkat untuk konteks penyajian baru.

unnamedParam2

Menentukan bidang lapisan tempat Anda ingin mengikat konteks penyajian. Nilai 0 mengidentifikasi bidang utama. 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 .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks penyajian OpenGL.

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

Keterangan

Konteks penyajian adalah port yang dilalui semua perintah OpenGL. Setiap utas yang melakukan panggilan OpenGL harus memiliki satu konteks penyajian aktif saat ini. Konteks penyajian tidak sama dengan konteks perangkat; konteks penyajian berisi informasi khusus untuk OpenGL, sementara konteks perangkat berisi informasi khusus untuk GDI.

Sebelum Anda membuat konteks penyajian, atur format piksel konteks perangkat dengan fungsi SetPixelFormat . Anda dapat menggunakan konteks penyajian di bidang lapisan tertentu dari jendela hanya dengan format piksel yang identik.

Dengan aplikasi OpenGL yang menggunakan beberapa utas, Anda membuat konteks penyajian, memilihnya sebagai konteks penyajian utas saat ini, dan melakukan panggilan OpenGL untuk utas yang ditentukan. Ketika Anda selesai dengan konteks penyajian utas, panggil fungsi wglDeleteContext .

Contoh

Contoh kode berikut menunjukkan cara menggunakan wglCreateLayerContext.

// The following code fragment shows how to render to overlay 1  
// This example assumes that the pixel format of hdc includes   
// overlay plane 1  
 
HDC hdc; 
HGLRC; 
 
// create a rendering context for overlay plane 1  
hglrc = wglCreateLayerContext(hdc, 1); 
 
// make it the calling thread's current rendering context  
wglMakeCurrent(hdc, hglrc); 
 
// call OpenGL functions here. . .  
 
// when the rendering context is no longer needed. . .  
 
// make the rendering context not current  
wglMakeCurrent(NULL, NULL); 
 
// delete the rendering context  
wglDeleteContext(hglrc);

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