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
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
| Pustaka |
|
| DLL |
|