Bagikan melalui


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