glPushClientAttrib fonction)

Les fonctions glPushClientAttrib et glPopClientAttrib permettent d’enregistrer et de restaurer des groupes de variables d’état client sur la pile client-Attribute.

Syntaxe

void WINAPI glPushClientAttrib(
   GLbitfield mask
);

Paramètres

mask

Masque qui indique les attributs à enregistrer. Voici les constantes de masque symbolique et les États des clients OpenGL associés.

Valeur Signification
_bit de _ magasin de pixels client _ GL _
Attributs du mode de stockage en pixels.
_bit du _ tableau de vertex client _ du GL _
Attributs du tableau de vertex.
_Bits de _ tous _ les _ octets du client GL
tous les attributs d’état client empilables.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Le code d’erreur suivant peut être récupéré par la fonction glGetError .

Nom Signification
dépassement de capacité de la _ pile GL _
La fonction a été appelée alors que la pile client-attribut était pleine.

Notes

La fonction glPushClientAttrib utilise son paramètre mask pour déterminer les groupes de variables d’état client qui sont enregistrés sur la pile client-Attribute. Vous pouvez utiliser l’opérateur de bits or pour joindre des constantes symboliques acceptées afin de définir des bits et de construire un masque.

La fonction glPopClientAttrib restaure les valeurs des variables d’état client enregistrées avec glPushclientAttrib. Les variables d’état client qui n’ont pas encore été enregistrées restent inchangées. L’envoi d’attributs vers une pile d’attribut client complète ou la déduplication d’attributs d’une pile vide définit un indicateur d’erreur et aucune autre modification n’est apportée à l’État OpenGL. Par défaut, la pile des attributs du client est vide.

Certaines valeurs d’état client OpenGL ne peuvent pas être enregistrées sur la pile client-Attribute. Par exemple, vous ne pouvez pas enregistrer les États Select ou feedback sur la pile client-Attribute. La profondeur de la pile client-attribute est d’au moins 16.

Les fonctions glPushclientAttrib et glPopClientAttrib ne sont pas compilées dans des listes d’affichage, mais sont exécutées immédiatement.

Les fonctions glPushClientAttrib et glPopClientAttrib peuvent uniquement envoyer et dépiler les modes de stockage de pixels et les États du client de tableau de vertex. Vous devez utiliser glPushAttrib et glPopAttrib pour les États push et pop qui sont conservés sur le serveur.

Notes

Les fonctions glPushClientAttrib et glPopClientAttrib sont uniquement disponibles dans OpenGL version 1,1 ou ultérieure.

Les fonctions suivantes récupèrent les informations relatives à glPushClientAttrib et glPopClientAttrib:

glGet avec argument de la profondeur de la pile de l' _ attribut GL client _ _ _

glGet avec argument GL _ Max. profondeur de la pile des _ attributs du client _ _ _

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
GL. h
Bibliothèque
Opengl32. lib
DLL
Opengl32.dll

Voir aussi

glColorPointer

glDisableClientState

glEdgeFlagPointer

glEnableClientState

glGet

glGetError

glIndexPointer

glNormalPointer

glNewList

glPixelStore

glPushAttrib

glTexCoordPointer

glVertexPointer