glPopClientAttrib-Funktion

Mit den Funktionen glPushClientAttrib und glPopClientAttrib werden Gruppen von Clientzustandsvariablen im Clientattributstapel gespeichert und wiederhergestellt.

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 Clientattributstapel voll war.

Bemerkungen

Die glPushClientAttrib-Funktion verwendet ihren mask-Parameter, um zu bestimmen, welche Gruppen von Clientzustandsvariablen im Clientattributstapel gespeichert werden. Sie können den bitweise OR-Operator verwenden, um akzeptierte symbolische Konstanten zu verbinden, um Bits zu setzen und eine Maske zu erstellen.

Die glPopClientAttrib-Funktion stellt die Werte der zuletzt mit glPushclientAttrib gespeicherten Clientzustandsvariablen wieder auf. Clientzustandsvariablen, die nicht zuvor gespeichert wurden, bleiben unverändert. Durch Das Pushen von Attributen in einen vollständigen Clientattributstapel oder das Ausblenden von Attributen aus einem leeren Stapel wird ein Fehlerflag und keine andere Änderung am OpenGL-Zustand vorgenommen. Standardmäßig ist der Clientattributstapel leer.

Einige OpenGL-Clientzustandswerte können nicht im Clientattributstapel gespeichert werden. Beispielsweise können Sie die Auswahl- oder Feedbackzustände nicht im Clientattributstapel speichern. Die Tiefe des Clientattributstapels 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 Poppixelspeichermodi und Scheitelpunktarray-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 zu glPushClientAttrib und glPopClientAttrib ab:

glGet mit Argument GL _ CLIENT _ ATTRIB _ STACK _ DEPTH

glGet mit Argument GL _ MAX _ CLIENT _ ATTRIB _ STACK _ DEPTH

Requirements (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