glPushClientAttrib-Funktion
Mit den Funktionen glPushClientAttrib und glPopClientAttrib werden Gruppen von Clientzustandsvariablen im Clientattributstapel gespeichert und wiederhergestellt.
Syntax
void WINAPI glPushClientAttrib(
GLbitfield mask
);
Parameter
-
mask
-
Eine Maske, die angibt, welche Attribute gespeichert werden sollen. Im Folgenden sind die symbolischen Maskenkonstanten und die zugehörigen OpenGL-Clientzustände aufgeführt.
Wert Bedeutung - GL_CLIENT_PIXEL_STORE_BIT
Pixelspeichermodusattribute. - GL_CLIENT_VERTEX_ARRAY_BIT
Vertexarrayattribute. - GL_CLIENT_ALL_ATTRIB_BITs
alle stapelbaren Clientzustandsattribute.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Funktion wurde aufgerufen, während der Client-Attributstapel 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 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 Clientzustandsvariablen wieder her. Zuvor nicht gespeicherte Clientzustandsvariablen bleiben unverändert. Durch Pushen von Attributen in einen vollständigen Client-Attributstapel oder durch Einfügen 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 im Client-Attributstapel gespeichert werden. Sie können z. B. die Auswahl- oder Feedbackzustände nicht im Client-Attributstapel 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 mit 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 |
|
| Bibliothek |
|
| DLL |
|