glPopClientAttrib-Funktion

Die Funktionen glPushClientAttrib und glPopClientAttrib speichern und wiederherstellen Gruppen von Clientstatusvariablen auf dem Stapel client-attribut.

Syntax

void WINAPI glPopClientAttrib(void);

Parameter

Diese Funktion besitzt keine Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL_STACK_OVERFLOW
Die Funktion wurde aufgerufen, während der Clientattributestapel voll war.

Bemerkungen

Die glPushClientAttrib-Funktion verwendet ihren Maskenparameter, um zu bestimmen, welche Gruppen von Clientstatusvariablen im Clientattributstapel gespeichert werden. Sie können den bitweisen OR-Operator verwenden, um akzeptierte symbolische Konstanten zusammenzuführen, um Bits festzulegen und eine Maske zu erstellen.

Die glPopClientAttrib-Funktion stellt die Werte der zuletzt mit glPushclientAttrib gespeicherten Clientstatusvariablen wieder her. Zuvor nicht gespeicherte Clientstatusvariablen bleiben unverändert. Durch Pushen von Attributen auf einen vollständigen Client-Attributstapel oder durch Poppen von Attributen aus einem leeren Stapel wird ein Fehlerflag festgelegt, und es wird keine andere Änderung am OpenGL-Zustand vorgenommen. Standardmäßig ist der Clientattributestapel leer.

Einige OpenGL-Clientstatuswerte können nicht auf dem Clientattributestapel gespeichert werden. Beispielsweise können Sie die Auswahl- oder Feedbackzustände nicht auf dem Clientattributestapel speichern. Die Tiefe des Client-Attributstapels beträgt mindestens 16.

Die Funktionen glPushclientAttrib und glPopClientAttrib werden nicht in Anzeigelisten kompiliert, sondern sofort ausgeführt.

Die Funktionen glPushClientAttrib und glPopClientAttrib können nur Push- und Pop-Pixelspeichermodi und Vertexarray-Clientzustände verwenden. Sie müssen glPushAttrib und glPopAttrib verwenden, um Push- und Pop-Zustände zu übertragen, die auf dem Server beibehalten werden.

Hinweis

Die Funktionen glPushClientAttrib und glPopClientAttrib sind nur in OpenGL Version 1.1 oder höher verfügbar.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glPushClientAttrib und glPopClientAttrib ab:

glGet with argument GL_CLIENT_ATTRIB_STACK_DEPTH

glGet mit argument GL_MAX_CLIENT_ATTRIB_STACK_DEPTH

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glColorPointer

glDisableClientState

glEdgeFlagPointer

glEnableClientState

glGet

glGetError

glIndexPointer

glNormalPointer

glNewList

glPixelStore

glPushAttrib

glTexCoordPointer

glVertexPointer