fungsi glClear

Fungsi glClear menghapus buffer ke nilai yang telah ditetapkan.

Sintaks

void WINAPI glClear(
   GLbitfield mask
);

Parameter

masker

Operator bitwise ATAU masker yang menunjukkan buffer akan dibersihkan. Empat masker tersebut adalah sebagai berikut.

Nilai	Makna
GL_COLOR_BUFFER_BIT	Buffer saat ini diaktifkan untuk penulisan warna.
GL_DEPTH_BUFFER_BIT	Buffer kedalaman.
GL_ACCUM_BUFFER_BIT	Buffer akumulasi.
GL_STENCIL_BUFFER_BIT	Buffer stensil.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	Bit apa pun selain empat bit yang ditentukan diatur dalam masker.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glClear mengatur area bitplane jendela ke nilai yang sebelumnya dipilih oleh glClearColor, glClearIndex, glClearDepth, glClearStencil, dan glClearAccum. Anda dapat menghapus beberapa buffer warna secara bersamaan dengan memilih lebih dari satu buffer sekaligus menggunakan glDrawBuffer.

Tes kepemilikan piksel, uji gunting, dithering, dan writemasks buffer memengaruhi pengoperasian glClear. Kotak gunting mengikat wilayah yang dibersihkan. Fungsi glClear mengabaikan fungsi alfa, fungsi campuran, operasi logis, stensil, pemetaan tekstur, dan z-buffering.

Fungsi glClear mengambil argumen tunggal (masker) yang merupakan bitwise ATAU dari beberapa nilai yang menunjukkan buffer mana yang akan dibersihkan.

Nilai di mana setiap buffer dibersihkan tergantung pada pengaturan nilai yang jelas untuk buffer tersebut.

Jika buffer tidak ada, panggilan glClear yang diarahkan pada buffer tersebut tidak berpengaruh.

Fungsi berikut mengambil informasi yang terkait dengan glClear:

glGet dengan argumen GL_ACCUM_CLEAR_VALUE

glGet dengan argumen GL_DEPTH_CLEAR_VALUE

glGet dengan argumen GL_INDEX_CLEAR_VALUE

glGet dengan argumen GL_COLOR_CLEAR_VALUE

glGet dengan argumen GL_STENCIL_CLEAR_VALUE

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

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor