fungsi glIndexPointer

Artikel
06/13/2023

Fungsi glIndexPointer mendefinisikan array indeks warna.

Sintaks

void WINAPI glIndexPointer(
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Parameter

jenis: Jenis data setiap indeks warna dalam array menggunakan konstanta simbolis berikut: GL_SHORT, GL_INT, GL_FLOAT, GL_DOUBLE.
Langkahnya: Offset byte antara indeks warna berturut-turut. Ketika stride adalah nol, indeks warna dikemas erat dalam array.
Pointer: Penunjuk ke indeks warna pertama dalam array.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

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

Keterangan

Fungsi glIndexPointer menentukan lokasi dan data array indeks warna yang akan digunakan saat penyajian. Parameter jenis menentukan jenis data setiap indeks warna dan langkah menentukan offset byte dari satu indeks warna ke indeks warna berikutnya, memungkinkan pengemasan simpul dan atribut dalam satu array atau penyimpanan dalam array terpisah. Dalam beberapa implementasi, menyimpan simpul dan atribut dalam satu array bisa lebih efisien daripada menggunakan array terpisah. Untuk informasi selengkapnya, lihat glInterleavedArrays.

Array indeks warna diaktifkan saat Anda menentukan konstanta GL_INDEX_ARRAY dengan glEnableClientState. Saat diaktifkan, glDrawArrays dan glArrayElement menggunakan array indeks warna. Secara default array indeks warna dinonaktifkan.

Anda tidak dapat menyertakan glIndexPointer dalam daftar tampilan.

Saat Anda menentukan array indeks warna menggunakan glIndexPointer, nilai semua parameter array indeks warna fungsi disimpan dalam status sisi klien dan elemen array statis dapat di-cache. Karena parameter array indeks warna adalah status sisi klien, nilainya tidak disimpan atau dipulihkan oleh glPushAttrib dan glPopAttrib.

Meskipun tidak ada kesalahan yang dihasilkan ketika Anda memanggil glIndexPointer dalam pasangan glBegin dan glEnd , hasilnya tidak terdefinisi.

Fungsi berikut mengambil informasi yang terkait dengan glIndexPointer:

glIsEnabled dengan argumen GL_INDEX_ARRAY

glGet dengan argumen GL_INDEX_ARRAY_STRIDE

glGet dengan argumen GL_INDEX_ARRAY_COUNT

glGet dengan argumen GL_INDEX_ARRAY_TYPE

glGet dengan argumen GL_INDEX_ARRAY_SIZE

glGetPointerv dengan argumen GL_INDEX_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
glColorPointer
glDrawArrays
glEdgeFlagPointer
glGetPointerv
glGetString
glNormalPointer
glPushAttrib
glTexCoordPointer
glVertexPointer

Bagikan melalui