fungsi glVertexPointer

Fungsi glVertexPointer mendefinisikan array data vertex.

Sintaks

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

Parameter

ukuran

Jumlah koordinat per puncak. Nilai ukuran harus 2, 3, atau 4.

jenis

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

Langkahnya

Offset byte antara simpul berturut-turut. Ketika langkah adalah nol, simpul dikemas erat dalam array.

Pointer

Penunjuk ke koordinat pertama vertex pertama dalam array.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

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

Keterangan

Fungsi glVertexPointer menentukan lokasi dan data array koordinat vertex untuk digunakan saat penyajian. Parameter ukuran menentukan jumlah koordinat per puncak. Parameter jenis menentukan jenis data dari setiap koordinat puncak. Parameter langkah menentukan offset byte dari satu puncak ke puncak 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 (lihat glInterleavedArrays).

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

Anda tidak dapat menyertakan glVertexPointer dalam daftar tampilan.

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

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

Fungsi berikut mengambil informasi yang terkait dengan glVertexPointer:

glGet dengan argumen GL_VERTEX_ARRAY_SIZE

glGet dengan argumen GL_VERTEX_ARRAY_STRIDE

glGet dengan argumen GL_VERTEX_ARRAY_COUNT

glGet dengan argumen GL_VERTEX_ARRAY_TYPE

glGetPointerv dengan argumen GL_VERTEX_ARRAY_POINTER

glIsEnabled dengan argumen GL_VERTEX_ARRAY

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

glEnableClientState

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glTexCoordPointer