glGetColorTableParameterivEXT (Fungsi glGetColorTableParameterivEXT)

Artikel
06/13/2023

Fungsi glGetColorTableParameterfvEXT dan glGetColorTableParameterivEXT mendapatkan parameter palet dari tabel warna.

Sintaks

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

Parameter

target

Tekstur target palet yang Anda inginkan data parameternya. Harus TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D, atau PROXY_TEXTURE_2D.

pname

Konstanta simbolis untuk jenis data parameter palet yang diacu oleh param.

Berikut ini adalah konstanta simbolis yang diterima dan maknanya.

Nilai	Makna
GL_COLOR_TABLE_FORMAT_EXT	Mengembalikan format internal yang ditentukan oleh panggilan terbaru ke glColorTableEXT atau nilai default.
GL_COLOR_TABLE_WIDTH_EXT	Mengembalikan lebar palet saat ini.
GL_COLOR_TABLE_RED_SIZE_EXT	Mengembalikan ukuran aktual yang digunakan secara internal untuk menyimpan komponen merah dari data palet.
GL_COLOR_TABLE_GREEN_SIZE_EXT	Mengembalikan ukuran aktual yang digunakan secara internal untuk menyimpan komponen hijau dari data palet.
GL_COLOR_TABLE_BLUE_SIZE_EXT	Mengembalikan ukuran aktual yang digunakan secara internal untuk menyimpan komponen biru dari data palet.
GL_COLOR_TABLE_ALPHA_SIZE_EXT	Mengembalikan ukuran aktual yang digunakan secara internal untuk menyimpan komponen alfa dari data palet.

params

Menunjuk ke data parameter tabel warna yang ditentukan oleh parameter pname .

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Anda menggunakan fungsi glGetColorTableParameterivEXT dan glGetColorTableParameterfvEXT untuk mengambil data parameter tertentu dari tabel warna yang diatur dengan glColorTableEXT untuk palet tekstur yang ditargetkan. Anda juga dapat menggunakan fungsi-fungsi ini untuk menentukan jumlah entri tabel warna yang dikembalikan glGetColorTableEXT .

Ketika parameter target GL_PROXY_TEXTURE_1D atau GL_PROXY_TEXTURE_2D, dan implementasi tidak mendukung nilai yang ditentukan untuk format atau lebar, glColorTableEXT dapat gagal membuat tabel warna yang diminta. Dalam hal ini, tabel warna kosong dan semua parameter yang diambil akan menjadi nol. Anda dapat menentukan apakah OpenGL mendukung format dan ukuran tabel warna tertentu dengan memanggil glColorTableEXT dengan target proksi, lalu memanggil glGetColorTableParameterivEXT atau glGetColorTableParameterfvEXT untuk menentukan apakah parameter lebar cocok dengan yang ditetapkan oleh glColorTableEXT. Jika lebar yang diambil adalah nol, permintaan tabel warna oleh glColorTable gagal. Jika lebar yang diambil bukan nol, Anda dapat memanggil glColorTable dengan target nyata dengan TEXTURE_1D atau TEXTURE_2D untuk mengatur tabel warna.

Fungsi glGetColorTableParameterivEXT dan glGetColorTableParameterfvEXT adalah fungsi ekstensi yang bukan bagian dari pustaka OpenGL standar tetapi merupakan bagian dari ekstensi GL_EXT_paletted_texture. Untuk memeriksa apakah implementasi OpenGL Anda mendukung glGetColorTableParameterivEXT dan glGetColorTableParameterfvEXT, panggil glGetString(GL_EXTENSIONS). Jika mengembalikan GL_EXT_paletted_texture, glGetColorTableParameterivEXT dan glGetColorTableParameterfvEXT didukung. Untuk mendapatkan alamat fungsi fungsi ekstensi, panggil wglGetProcAddress.

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

Lihat juga

glColorSubTableEXT
glColorTableEXT
glGetColorTableEXT
glGetColorTableParameterfvEXT
wglGetProcAddress

Share via