fungsi glDrawElements

Artikel
06/13/2023

Fungsi glDrawElements merender primitif dari data array.

Sintaks

void WINAPI glDrawElements(
         GLenum  mode,
         GLsizei count,
         GLenum  type,
   const GLvoid  *indices
);

Parameter

mode: Jenis primitif untuk dirender. Ini dapat mengasumsikan salah satu nilai simbolis berikut: GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS, dan GL_POLYGON.
hitung: Jumlah elemen yang akan dirender.
jenis: Jenis nilai dalam indeks. Harus salah satu GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT, atau GL_UNSIGNED_INT.
indeks: Penunjuk ke lokasi tempat indeks disimpan.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	mode bukan nilai yang diterima.
GL_INVALID_VALUE	hitungan adalah nilai negatif.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glDrawElements memungkinkan Anda menentukan beberapa primitif geometris dengan sangat sedikit panggilan fungsi. Alih-alih memanggil fungsi OpenGL untuk melewati setiap puncak individu, normal, atau warna, Anda dapat menentukan array simpul, normal, dan warna terpisah sebelumnya dan menggunakannya untuk menentukan urutan primitif (semua jenis yang sama) dengan satu panggilan ke glDrawElements.

Ketika Anda memanggil fungsi glDrawElements, fungsi ini menggunakan menghitung elemen berurutan dari indeks untuk membangun urutan primitif geometris. Parameter mode menentukan jenis primitif apa yang dibangun, dan bagaimana elemen array digunakan untuk membangun primitif ini. Jika GL_VERTEX_ARRAY tidak diaktifkan, tidak ada primitif geometris yang dihasilkan.

Atribut vertex yang dimodifikasi oleh glDrawElements memiliki nilai yang tidak ditentukan setelah glDrawElements kembali. Misalnya, jika GL_COLOR_ARRAY diaktifkan, nilai warna saat ini tidak terdefinisi setelah glDrawElements dijalankan. Atribut yang tidak dimodifikasi tetap tidak berubah.

Anda dapat menyertakan fungsi glDrawElements dalam daftar tampilan. Saat glDrawElements disertakan dalam daftar tampilan, data array yang diperlukan (ditentukan oleh penunjuk array dan pengaktifan) juga dimasukkan ke dalam daftar tampilan. Karena penunjuk array dan pengaktifan adalah variabel status sisi klien, nilainya mempengaruhi daftar tampilan saat daftar dibuat, bukan saat daftar dijalankan.

Catatan

Fungsi glDrawElements hanya tersedia di OpenGL versi 1.1 atau yang lebih baru.

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
glColorPointer
glDrawArrays
glEdgeFlagPointer
glEnd
glGetPointerv
glIndexPointer
glNormalPointer
glTexCoordPointer
glVertexPointer

Bagikan melalui