fungsi glCallLists

Fungsi glCallLists menjalankan daftar daftar tampilan.

Sintaks

void WINAPI glCallLists(
         GLsizei n,
         GLenum  type,
   const GLvoid  *lists
);

Parameter

n

Jumlah daftar tampilan yang akan dijalankan.

jenis

Jenis nilai dalam daftar. Konstanta simbolis berikut diterima.

Nilai	Makna
GL_BYTE	Parameter daftar diperlakukan sebagai array byte yang ditandatangani, masing-masing dalam rentang -128 hingga 127.
GL_UNSIGNED_BYTE	Parameter daftar diperlakukan sebagai array byte yang tidak ditandatangani, masing-masing dalam rentang 0 hingga 255.
GL_SHORT	Parameter daftar diperlakukan sebagai array bilangan bulat 2-byte yang ditandatangani, masing-masing dalam rentang -32768 hingga 32767.
GL_UNSIGNED_SHORT	Parameter daftar diperlakukan sebagai array bilangan bulat 2-byte yang tidak ditandatangani, masing-masing dalam rentang 0 hingga 65535.
GL_INT	Parameter daftar diperlakukan sebagai array bilangan bulat 4 byte yang ditandatangani.
GL_UNSIGNED_INT	Parameter daftar diperlakukan sebagai array bilangan bulat 4-byte yang tidak ditandatangani.
GL_FLOAT	Parameter daftar diperlakukan sebagai array nilai floating-point 4-byte.
GL_2_BYTES	Parameter daftar diperlakukan sebagai array byte yang tidak ditandatangani. Setiap pasangan byte menentukan satu nama daftar tampilan. Nilai pasangan dihitung sebagai 256 kali nilai tidak ditandatangani dari byte pertama ditambah nilai byte kedua yang tidak ditandatangani.
GL_3_BYTES	Parameter daftar diperlakukan sebagai array byte yang tidak ditandatangani. Setiap kembung byte menentukan satu nama daftar tampilan. Nilai triplet dihitung sebagai 65536 kali nilai byte pertama yang tidak ditandatangani, ditambah 256 kali nilai byte kedua yang tidak ditandatangani, ditambah nilai byte ketiga yang tidak ditandatangani.
GL_4_BYTES	Parameter daftar diperlakukan sebagai array byte yang tidak ditandatangani. Setiap quadruplet byte menentukan satu nama daftar tampilan. Nilai quadruplet dihitung sebagai 16777216 kali nilai byte pertama yang tidak ditandatangani, ditambah 65536 kali nilai byte kedua yang tidak ditandatangani, ditambah 256 kali nilai byte ketiga yang tidak ditandatangani, ditambah nilai byte keempat yang tidak ditandatangani.

Daftar

Alamat array offset nama dalam daftar tampilan. Jenis penunjuk dibatalkan karena offset dapat berupa byte, celana pendek, ints, atau float, tergantung pada nilai jenisnya.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Fungsi glCallLists menyebabkan setiap daftar tampilan dalam daftar nama yang diteruskan sebagai daftar yang akan dijalankan. Akibatnya, fungsi yang disimpan di setiap daftar tampilan dijalankan secara berurutan, sama seperti jika dipanggil tanpa menggunakan daftar tampilan. Nama daftar tampilan yang belum ditentukan diabaikan.

Fungsi glCallLists menyediakan cara yang efisien untuk mengeksekusi daftar tampilan. Parameter n menentukan jumlah daftar dengan berbagai format nama (ditentukan oleh parameter jenis ) yang dijalankan glCallLists .

Daftar nama daftar tampilan tidak dihentikan null. Sebaliknya, n menentukan berapa banyak nama yang akan diambil dari daftar.

Fungsi glListBase membuat tingkat tidak langsung tambahan tersedia. Fungsi glListBase menentukan offset yang tidak ditandatangani yang ditambahkan ke setiap nama daftar tampilan yang ditentukan dalam daftar sebelum daftar tampilan tersebut dijalankan.

Fungsi glCallLists dapat muncul di dalam daftar tampilan. Untuk menghindari kemungkinan rekursi tak terbatas yang dihasilkan dari daftar tampilan yang memanggil satu sama lain, batas ditempatkan pada tingkat berlapis daftar tampilan selama eksekusi daftar tampilan. Batas ini harus setidaknya 64, dan tergantung pada implementasinya.

Status OpenGL tidak disimpan dan dipulihkan di seluruh panggilan ke glCallLists. Dengan demikian, perubahan yang dilakukan pada status OpenGL selama eksekusi daftar tampilan tetap ada setelah eksekusi selesai. Gunakan glPushAttrib, glPopAttrib, glPushMatrix, dan glPopMatrix untuk mempertahankan status OpenGL di seluruh panggilan glCallLists .

Anda dapat menjalankan daftar tampilan antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd, selama daftar tampilan hanya menyertakan fungsi yang diizinkan dalam interval ini.

Fungsi berikut mengambil informasi yang terkait dengan fungsi glCallLists :

glGet dengan argumen GL_LIST_BASE

glGet dengan argumen GL_MAX_LIST_NESTING

glIsList

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

glBegin

glCallList

glDeleteLists

glEnd

glGenLists

glGet

glIsList

glListBase

glNewList

glPopAttrib

glPopMatrix

glPushAttrib

glPushMatrix