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 menentukan 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 verteks pertama ke yang terakhir, lalu kembali ke yang pertama. Simpul n dan n + 1 menentukan baris n. Baris terakhir, bagaimanapun, 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 sekelompok 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 tentukan segitiga n. Bahkan n, simpul n + 1, n, dan n + 2 menentukan segitiga n. N - 2 segitiga digambar.
GL_TRIANGLE_FAN
Menggambar sekelompok 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. N/4 kuadrilateral digambar.
GL_QUAD_STRIP
Menggambar sekelompok quadrilateral yang terhubung. Satu quadrilateral didefinisikan untuk setiap pasangan simpul yang disajikan setelah pasangan pertama. Simpul 2n - 1, 2n, 2n + 2, dan 2n + 1 mendefinisikan quadrilateral n. N/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 hingga N mendefinisikan poligon ini.

Mengembalikan nilai

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. Glend fungsi dipanggil sebelum glBegin yang sesuai dipanggil, atau glBegin dipanggil dalam urutan glBeginglend/.

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 [khusus 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