fungsi glPushClientAttrib

Artikel
06/13/2023

Fungsi glPushClientAttrib dan glPopClientAttrib menyimpan dan memulihkan grup variabel status klien pada tumpukan atribut klien.

Sintaks

void WINAPI glPushClientAttrib(
   GLbitfield mask
);

Parameter

masker

Masker yang menunjukkan atribut mana yang akan disimpan. Berikut ini adalah konstanta masker simbolis dan status klien OpenGL terkait.

Nilai	Makna
GL_CLIENT_PIXEL_STORE_BIT	Atribut mode penyimpanan piksel.
GL_CLIENT_VERTEX_ARRAY_BIT	Atribut array vertex.
GL_CLIENT_ALL_ATTRIB_BITs	semua atribut status klien yang dapat ditumpuk.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_STACK_OVERFLOW	Fungsi ini dipanggil saat tumpukan atribut klien penuh.

Keterangan

Fungsi glPushClientAttrib menggunakan parameter mask-nya untuk menentukan grup variabel status klien mana yang disimpan pada tumpukan atribut klien. Anda dapat menggunakan operator OR bitwise untuk menggabungkan bersama-sama konstanta simbolis yang diterima untuk mengatur bit dan membuat masker.

Fungsi glPopClientAttrib memulihkan nilai variabel client-state terakhir disimpan dengan glPushclientAttrib. Variabel status klien yang sebelumnya tidak disimpan tidak berubah. Mendorong atribut ke tumpukan atribut klien lengkap atau memunculkan atribut dari tumpukan kosong menetapkan bendera kesalahan dan tidak ada perubahan lain yang dilakukan pada status OpenGL. Secara default tumpukan atribut klien kosong.

Beberapa nilai status klien OpenGL tidak dapat disimpan pada tumpukan atribut klien. Misalnya, Anda tidak dapat menyimpan status pilih atau umpan balik pada tumpukan atribut klien. Kedalaman tumpukan atribut klien setidaknya 16.

Fungsi glPushclientAttrib dan glPopClientAttrib tidak dikompilasi ke dalam daftar tampilan, tetapi segera dijalankan.

Fungsi glPushClientAttrib dan glPopClientAttrib hanya dapat mendorong dan memunculkan mode penyimpanan piksel dan status klien array verteks. Anda harus menggunakan glPushAttrib dan glPopAttrib untuk mendorong dan memunculkan status yang disimpan di server.

Catatan

Fungsi glPushClientAttrib dan glPopClientAttrib hanya tersedia di OpenGL versi 1.1 atau yang lebih baru.

Fungsi berikut mengambil informasi yang terkait dengan glPushClientAttrib dan glPopClientAttrib:

glGet dengan argumen GL_CLIENT_ATTRIB_STACK_DEPTH

glGet dengan argumen GL_MAX_CLIENT_ATTRIB_STACK_DEPTH

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

glColorPointer
glDisableClientState
glEdgeFlagPointer
glEnableClientState
glGet
glGetError
glIndexPointer
glNormalPointer
glNewList
glPixelStore
glPushAttrib
glTexCoordPointer
glVertexPointer