fungsi glTexCoordPointer

Fungsi glTexCoordPointer mendefinisikan array koordinat tekstur.

Sintaks

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

Parameter

ukuran

Jumlah koordinat per elemen array. Nilai ukuran harus 1, 2, 3, atau 4.

jenis

Jenis data setiap koordinat tekstur dalam array menggunakan konstanta simbolis berikut: GL_SHORT, GL_INT, GL_FLOAT, dan GL_DOUBLE.

Langkahnya

Offset byte antara elemen array berturut-turut. Saat langkah adalah nol, elemen array dikemas erat dalam array.

Pointer

Penunjuk ke koordinat pertama elemen pertama dalam array.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	type bukan nilai yang diterima.
GL_INVALID_VALUE	ukurannya bukan 1, 2, 3, atau 4.
GL_INVALID_VALUE	langkah negatif.

Keterangan

Fungsi glTexCoordPointer menentukan lokasi dan data array koordinat tekstur untuk digunakan saat penyajian. Parameter ukuran menentukan jumlah koordinat yang digunakan untuk setiap elemen array. Parameter jenis menentukan jenis data dari setiap koordinat tekstur. Parameter langkah menentukan offset byte dari satu elemen array ke elemen 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. Saat array koordinat tekstur ditentukan, ukuran, jenis, langkah, dan penunjuk disimpan dalam status sisi klien.

Array koordinat tekstur diaktifkan saat Anda menentukan konstanta GL_TEXTURE_COORD_ARRAY dengan glEnableClientState. Saat diaktifkan, glDrawArrays, glDrawElements, dan glArrayElement menggunakan array koordinat tekstur. Secara default array koordinat tekstur dinonaktifkan.

Anda tidak dapat menyertakan glTexCoordPointer dalam daftar tampilan.

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

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

Fungsi berikut mengambil informasi yang terkait dengan glTexCoordPointer:

glIsEnabled dengan argumen GL_TEXTURE_COORD_ARRAY

glGet dengan GL_TEXTURE_COORD_ARRAY_SIZE argumen

glGet dengan argumen GL_TEXTURE_COORD_ARRAY_STRIDE

glGet dengan argumen GL_TEXTURE_COORD_ARRAY_COUNT

glGet dengan argumen GL_TEXTURE_COORD_ARRAY_TYPE

glGetPointerv dengan argumen GL_TEXTURE_COORD_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

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer