fungsi glDrawArrays

Artikel
06/13/2023

Fungsi glDrawArrays menentukan beberapa primitif untuk dirender.

Sintaks

void WINAPI glDrawArrays(
   GLenum  mode,
   GLint   first,
   GLsizei count
);

Parameter

mode: Jenis primitif untuk dirender. Konstanta berikut menentukan jenis primitif yang dapat diterima: 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.
pertama: Indeks awal dalam array yang diaktifkan.
hitung: Jumlah indeks yang akan dirender.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

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

Keterangan

Dengan glDrawArrays, Anda dapat menentukan beberapa primitif geometris untuk dirender. Alih-alih memanggil fungsi OpenGL terpisah untuk melewati setiap puncak, normal, atau warna individual, Anda dapat menentukan array simpul, normal, dan warna terpisah untuk menentukan urutan primitif (semua jenis yang sama) dengan satu panggilan ke glDrawArrays.

Saat Anda memanggil glDrawArrays, menghitung elemen berurutan dari setiap array yang diaktifkan digunakan untuk membangun urutan primitif geometris, dimulai dengan elemen pertama . Parameter mode menentukan jenis primitif apa yang akan dibangun dan cara menggunakan elemen array untuk membangun primitif.

Setelah glDrawArrays kembali, nilai atribut vertex yang dimodifikasi oleh glDrawArrays tidak ditentukan. Misalnya, jika GL_COLOR_ARRAY diaktifkan, nilai warna saat ini tidak terdefinisi setelah glDrawArrays kembali. Atribut yang tidak dimodifikasi oleh glDrawArrays tetap ditentukan. Ketika GL_VERTEX_ARRAY tidak diaktifkan, tidak ada primitif geometris yang dihasilkan tetapi atribut yang sesuai dengan array yang diaktifkan dimodifikasi.

Anda dapat menyertakan glDrawArrays dalam daftar tampilan. Saat Anda menyertakan glDrawArrays dalam daftar tampilan, data array yang diperlukan, ditentukan oleh penunjuk array dan pengaktifan, dihasilkan dan dimasukkan dalam daftar tampilan. Nilai penunjuk array dan pengaktifan ditentukan selama pembuatan daftar tampilan.

Anda dapat membaca data array statis kapan saja. Jika ada elemen array statis yang dimodifikasi dan array tidak ditentukan lagi, hasil panggilan berikutnya ke glDrawArrays tidak terdefinisi.

Meskipun tidak ada kesalahan yang dihasilkan ketika Anda menentukan array lebih dari sekali dalam pasangan glBegin dan glend , hasilnya tidak terdefinisi.

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

Bagikan melalui