fungsi glGetError

Fungsi glGetError mengembalikan informasi kesalahan.

Sintaks

GLenum WINAPI glGetError(void);

Parameter

Fungsi ini tidak memiliki parameter.

Menampilkan nilai

Fungsi glGetError mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
GL_INVALID_ENUM	Nilai yang tidak dapat diterima ditentukan untuk argumen enumerasi. Fungsi yang menyinggung diabaikan, tidak memiliki efek samping selain mengatur bendera kesalahan.
GL_INVALID_VALUE	Argumen numerik di luar rentang. Fungsi yang menyinggung diabaikan, tidak memiliki efek samping selain mengatur bendera kesalahan.
GL_INVALID_OPERATION	Operasi yang ditentukan tidak diperbolehkan dalam status saat ini. Fungsi yang menyinggung diabaikan, tidak memiliki efek samping selain mengatur bendera kesalahan.
GL_NO_ERROR	Tidak ada kesalahan yang direkam. Nilai konstanta simbolis ini dijamin nol.
GL_STACK_OVERFLOW	Fungsi ini akan menyebabkan luapan tumpukan. Fungsi yang menyinggung diabaikan, tidak memiliki efek samping selain mengatur bendera kesalahan.
GL_STACK_UNDERFLOW	Fungsi ini akan menyebabkan stack underflow. Fungsi yang menyinggung diabaikan, tidak memiliki efek samping selain mengatur bendera kesalahan.
GL_OUT_OF_MEMORY	Memori yang tersisa tidak cukup untuk menjalankan fungsi. Status OpenGL tidak terdefinisi, kecuali untuk status bendera kesalahan, setelah kesalahan ini direkam.

Perhatikan bahwa glGetError mengembalikan GL_INVALID_OPERATION jika dipanggil di antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Setiap kesalahan yang dapat dideteksi diberi kode numerik dan nama simbolis. Ketika kesalahan terjadi, bendera kesalahan diatur ke nilai kode kesalahan yang sesuai. Tidak ada kesalahan lain yang direkam hingga glGetError dipanggil, kode kesalahan dikembalikan, dan bendera diatur ulang ke GL_NO_ERROR. Jika panggilan ke glGetError mengembalikan GL_NO_ERROR, tidak ada kesalahan yang dapat dideteksi sejak panggilan terakhir ke glGetError, atau sejak OpenGL diinisialisasi.

Untuk memungkinkan implementasi terdistribusi, mungkin ada beberapa bendera kesalahan. Jika ada bendera kesalahan tunggal yang merekam kesalahan, nilai bendera tersebut dikembalikan dan bendera tersebut direset ke GL_NO_ERROR saat glGetError dipanggil. Jika lebih dari satu bendera telah merekam kesalahan, glGetError mengembalikan dan menghapus nilai bendera kesalahan arbitrer. Jika semua bendera kesalahan akan diatur ulang, Anda harus selalu memanggil glGetError dalam perulangan hingga kembali GL_NO_ERROR.

Awalnya, semua bendera kesalahan diatur ke GL_NO_ERROR.

Ketika bendera kesalahan diatur, hasil operasi OpenGL tidak terdefinisi hanya jika GL_OUT_OF_MEMORY telah terjadi. Dalam semua kasus lain, fungsi yang menghasilkan kesalahan diabaikan dan tidak berpengaruh pada konten status OpenGL atau framebuffer.

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

glEnd