fungsi glColorPointer

Artikel
06/12/2023

Fungsi glColorPointer mendefinisikan array warna.

Sintaks

void WINAPI glColorPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Parameter

ukuran: Jumlah komponen per warna. Nilainya harus 3 atau 4.
jenis: Jenis data setiap komponen warna dalam array warna. Jenis data yang dapat diterima ditentukan dengan konstanta berikut: GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT, atau GL_DOUBLE.
Langkahnya: Offset byte antara warna berturut-turut. Ketika stride adalah nol, warna dikemas erat dalam array.
Pointer: Penunjuk ke komponen pertama dari elemen warna pertama dalam array warna.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	ukurannya bukan 3 atau 4.
GL_INVALID_ENUM	tipe bukan nilai yang diterima.
GL_INVALID_VALUE	langkah atau hitungan negatif.

Keterangan

Fungsi glColorPointer menentukan lokasi dan format data dari array komponen warna yang akan digunakan saat penyajian. Parameter stride menentukan offset byte dari satu warna ke warna berikutnya, memungkinkan pengemasan atribut vertex dalam satu array atau penyimpanan dalam array terpisah. Dalam beberapa implementasi, menyimpan atribut vertex dalam satu array bisa lebih efisien daripada penggunaan array terpisah.

Mengaktifkan array warna dengan menentukan konstanta GL_COLOR_ARRAY dengan glEnableClientState. Memanggil glArrayElement, glDrawElements, atau glDrawArrays menggunakan array warna yang dengan demikian diaktifkan. Secara default, array warna dinonaktifkan. Panggilan glColorPointer tidak dapat dengan dimasukkan dalam daftar tampilan.

Saat Anda menentukan array warna menggunakan glColorPointer, nilai semua parameter array warna fungsi disimpan dalam status sisi klien, dan Anda dapat menyimpan elemen array statis. Karena parameter array warna dalam status sisi klien, glPushAttrib dan glPopAttrib tidak menyimpan atau memulihkan nilai parameter.

Meskipun menentukan array warna dalam pasangan glBegin dan glend tidak menghasilkan kesalahan, hasilnya tidak terdefinisi.

Fungsi berikut mengambil informasi yang terkait dengan fungsi glColorPointer :

glIsEnabled dengan argumen GL_COLOR_ARRAY

glGet dengan argumen GL_COLOR_ARRAY_SIZE

glGet dengan argumen GL_COLOR_ARRAY_TYPE

glGet dengan argumen GL_COLOR_ARRAY_STRIDE

glGet dengan argumen GL_COLOR_ARRAY_COUNT

glGetPointerv dengan argumen GL_COLOR_ARRAY_POINTER

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

glArrayElement
glBegin
glDrawArrays
glEdgeFlagPointer
glEnableClientState
glEnd
glGet
glGetString
glGetPointerv
glIndexPointer
glIsEnabled
glNormalPointer
glPopAttrib
glPushAttrib
glTexCoordPointer
glVertexPointer