fungsi glGetString

Fungsi glGetString mengembalikan string yang menjelaskan koneksi OpenGL saat ini.

Sintaks

const GLubyte* WINAPI glGetString(
   GLenum name
);

Parameter

nama

Salah satu konstanta simbolis berikut.

Nilai	Makna
GL_VENDOR	Mengembalikan perusahaan yang bertanggung jawab atas implementasi OpenGL ini. Nama ini tidak berubah dari rilis ke rilis.
GL_RENDERER	Mengembalikan nama perender. Nama ini biasanya khusus untuk konfigurasi tertentu dari platform perangkat keras. Ini tidak berubah dari rilis ke rilis.
GL_VERSION	Mengembalikan versi atau nomor rilis.
GL_EXTENSIONS	Mengembalikan daftar ekstensi yang didukung yang dipisahkan spasi ke OpenGL.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	nama bukan nilai yang diterima.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glGetString mengembalikan penunjuk ke string statis yang menjelaskan beberapa aspek koneksi OpenGL saat ini.

Karena OpenGL tidak menyertakan kueri untuk karakteristik performa implementasi, diharapkan beberapa aplikasi akan ditulis untuk mengenali platform yang diketahui dan akan memodifikasi penggunaan OpenGL mereka berdasarkan karakteristik performa yang diketahui dari platform ini. String GL_VENDOR dan GL_RENDERER bersama-sama secara unik menentukan platform, dan tidak akan berubah dari rilis ke rilis. Mereka harus digunakan seperti itu oleh algoritma pengenalan platform.

Format dan konten string yang dikembalikan glGetString bergantung pada implementasinya, kecuali bahwa:

• Nama ekstensi tidak akan menyertakan karakter spasi dan akan dipisahkan oleh karakter spasi dalam string GL_EXTENSIONS.

• String GL_VERSION dimulai dengan nomor versi. Nomor versi menggunakan salah satu formulir ini:

  major_number. minor_number

  major_number. minor_number. release_number

• Informasi khusus vendor dapat mengikuti nomor versi. Formatnya tergantung pada implementasinya, tetapi ruang selalu memisahkan nomor versi dan informasi khusus vendor.

• Semua string dihentikan null.

Jika kesalahan dihasilkan, glGetString mengembalikan nol.

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