fungsi glBegin

Fungsi glBegin dan glend memisahkan simpul primitif atau sekelompok primitif seperti.

Sintaks

void WINAPI glBegin(
   GLenum mode
);

Parameter

mode

Primitif atau primitif yang akan dibuat dari simpul yang disajikan antara glBegin dan glend berikutnya. Berikut ini adalah konstanta simbolis yang diterima dan maknanya:

Nilai	Makna
GL_POINTS	Memperlakukan setiap puncak sebagai satu titik. Vertex n mendefinisikan titik n. N poin digambar.
GL_LINES	Memperlakukan setiap pasang simpul sebagai segmen garis independen. Simpul 2n - 1 dan 2n mendefinisikan baris n. Garis N/2 digambar.
GL_LINE_STRIP	Menggambar sekelompok segmen garis yang terhubung dari puncak pertama ke yang terakhir. Simpul n dan n+1 menentukan baris n. N - 1 garis digambar.
GL_LINE_LOOP	Menggambar sekelompok segmen garis yang terhubung dari puncak pertama ke yang terakhir, lalu kembali ke yang pertama. Simpul n dan n + 1 mendefinisikan baris n. Namun, baris terakhir didefinisikan oleh simpul N dan 1. Garis N digambar.
GL_TRIANGLES	Memperlakukan setiap kembung simpul sebagai segitiga independen. Simpul 3n - 2, 3n - 1, dan 3n mendefinisikan segitiga n. Segitiga N/3 digambar.
GL_TRIANGLE_STRIP	Menggambar segitiga yang terhubung. Satu segitiga didefinisikan untuk setiap puncak yang disajikan setelah dua simpul pertama. Untuk n ganjil, simpul n, n + 1, dan n + 2 mendefinisikan segitiga n. Bahkan untuk n, simpul n + 1, n, dan n + 2 mendefinisikan segitiga n. N - 2 segitiga digambar.
GL_TRIANGLE_FAN	Menggambar segitiga yang terhubung. satu segitiga didefinisikan untuk setiap puncak yang disajikan setelah dua simpul pertama. Simpul 1, n + 1, n + 2 mendefinisikan segitiga n. N - 2 segitiga digambar.
GL_QUADS	Memperlakukan setiap kelompok empat simpul sebagai quadrilateral independen. Simpul 4n - 3, 4n - 2, 4n - 1, dan 4n mendefinisikan quadrilateral n. Kuadrilateral N/4 digambar.
GL_QUAD_STRIP	Menggambar sekelompok quadrilateral yang terhubung. Satu kuadrilateral didefinisikan untuk setiap pasangan simpul yang disajikan setelah pasangan pertama. Simpul 2n - 1, 2n, 2n + 2, dan 2n + 1 mendefinisikan quadrilateral n. T/2 - 1 kuadrilateral digambar. Perhatikan bahwa urutan di mana simpul digunakan untuk membangun quadrilateral dari data strip berbeda dari yang digunakan dengan data independen.
GL_POLYGON	Menggambar poligon cembung tunggal. Simpul 1 sampai N mendefinisikan poligon ini.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	mode diatur ke nilai yang tidak diterima.
GL_INVALID_OPERATION	Fungsi selain glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList, atau glCallLists dipanggil antara glBegin dan glend yang sesuai. Fungsi glend dipanggil sebelum glBegin yang sesuai dipanggil, atau glBegin dipanggil dalam urutan glBegin/glend .

Keterangan

Fungsi glBegin dan glend memisahkan simpul yang mendefinisikan primitif atau sekelompok primitif seperti. Fungsi glBegin menerima satu argumen yang menentukan mana dari sepuluh primitif yang menyusun simpul. Mengambil n sebagai jumlah bilangan bulat mulai dari satu, dan N sebagai jumlah total simpul yang ditentukan, interpretasinya adalah sebagai berikut:

• Anda hanya dapat menggunakan subset fungsi OpenGL antara glBegin dan glend. Fungsi yang dapat Anda gunakan adalah:

  glVertex

  glColor

  glIndex

  glNormal

  glTexCoord

  glEvalCoord

  glEvalPoint

  glMaterial

  glEdgeFlag

  Anda juga dapat menggunakan glCallList atau glCallLists untuk menjalankan daftar tampilan yang hanya menyertakan fungsi sebelumnya. Jika ada fungsi OpenGL lain yang dipanggil antara glBegin dan glend, bendera kesalahan diatur dan fungsi diabaikan.

• Terlepas dari nilai yang dipilih untuk mode di glBegin, tidak ada batasan jumlah simpul yang dapat Anda tentukan antara glBegin dan glend. Garis, segitiga, kuadrilateral, dan poligon yang tidak lengkap ditentukan tidak digambar. Hasil spesifikasi yang tidak lengkap ketika terlalu sedikit simpul disediakan untuk menentukan bahkan satu primitif atau ketika kelipatan simpul yang salah ditentukan. Primitif yang tidak lengkap diabaikan; primitif lengkap digambar.

• Spesifikasi minimum simpul untuk setiap primitif adalah:

  Jumlah minimum simpul	Jenis primitif
  1	point
  2	line
  3	segitiga
  4	Segiempat
  3	polygon

• Mode yang memerlukan beberapa simpul tertentu adalah GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4), dan GL_QUAD_STRIP (2).

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

glCallList

glCallLists

glColor

glEdgeFlag

glEnd

glEvalCoord

glEvalPoint

glIndex

glMaterial

glNormal

glTexCoord

glVertex