fungsi glDrawBuffer

Fungsi glDrawBuffer menentukan buffer warna mana yang akan digambar.

Sintaks

void WINAPI glDrawBuffer(
   GLenum mode
);

Parameter

mode

Menentukan hingga empat buffer warna yang akan digambar dengan konstanta simbolis berikut yang dapat diterima.

Nilai	Makna
GL_NONE	Tidak ada buffer warna yang ditulis.
GL_FRONT_LEFT	Hanya buffer warna kiri depan yang ditulis.
GL_FRONT_RIGHT	Hanya buffer warna kanan depan yang ditulis.
GL_BACK_LEFT	Hanya buffer warna kiri belakang yang ditulis.
GL_BACK_RIGHT	Hanya buffer warna kanan belakang yang ditulis.
GL_FRONT	Hanya buffer warna kiri depan dan kanan depan yang ditulis. Jika tidak ada buffer warna kanan depan, hanya buffer warna kiri depan yang ditulis.
GL_BACK	Hanya buffer warna kiri belakang dan kanan belakang yang ditulis. Jika tidak ada buffer warna kanan belakang, hanya buffer warna kiri belakang yang ditulis.
GL_LEFT	Hanya buffer warna kiri depan dan kiri belakang yang ditulis. Jika tidak ada buffer warna kiri belakang, hanya buffer warna kiri depan yang ditulis.
GL_RIGHT	Hanya buffer warna kanan depan dan kanan belakang yang ditulis. Jika tidak ada buffer warna kanan belakang, hanya buffer warna kanan depan yang ditulis.
GL_FRONT_AND_BACK	Semua buffer warna depan dan belakang (kiri depan, kanan depan, kiri belakang, kanan belakang) ditulis. Jika tidak ada buffer warna belakang, hanya buffer warna kiri depan dan kanan depan yang ditulis. Jika tidak ada buffer warna kanan, hanya buffer warna kiri depan dan kiri belakang yang ditulis. Jika tidak ada buffer warna kanan atau belakang, hanya buffer warna kiri depan yang ditulis.
GL_AUXi	Hanya buffer warna tambahan i yang ditulis; i adalah antara 0 dan GL_AUX_BUFFERS - 1. (GL_AUX_BUFFERS bukan batas atas; gunakan glGet untuk mengkueri jumlah buffer tambahan yang tersedia.)

Nilai default adalah GL_FRONT untuk konteks buffer tunggal, dan GL_BACK untuk konteks buffer ganda.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	mode bukan nilai yang diterima.
GL_INVALID_OPERATION	Tidak ada buffer yang ditunjukkan oleh mode yang ada.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Ketika warna ditulis ke framebuffer, warna ditulis ke dalam buffer warna yang ditentukan oleh glDrawBuffer.

Jika lebih dari satu buffer warna dipilih untuk menggambar, maka operasi perpaduan atau logis dihitung dan diterapkan secara independen untuk setiap buffer warna dan dapat menghasilkan hasil yang berbeda di setiap buffer.

Konteks monoskopis hanya mencakup buffer kiri, dan konteks stereoskopis mencakup buffer kiri dan kanan. Demikian juga, konteks buffer tunggal hanya mencakup buffer depan, dan konteks buffer ganda mencakup buffer depan dan belakang. Konteks dipilih pada inisialisasi OpenGL.

Selalu kasus yang GL_AUX i = GL_AUX0 + i.

Fungsi berikut mengambil informasi yang terkait dengan fungsi glDrawBuffer :

glGet dengan argumen GL_DRAW_BUFFER

glGet dengan argumen GL_AUX_BUFFERS

Persyaratan

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

Lihat juga

glBegin

glBlendFunc

glColorMask

glEnd

glGet

glIndexMask

glLogicOp

glReadBuffer