glPushAttrib fonction)

Exécute un push de la pile d’attributs.

Syntaxe

void WINAPI glPushAttrib(
   GLbitfield mask
);

Paramètres

mask

Masque qui indique les attributs à enregistrer. Les constantes de masque symbolique et leur état OpenGL associé sont les suivantes (la liste des paragraphes en retrait répertorie les attributs qui sont enregistrés) :

_bit de tampon amort _ _

Valeur effacée de la mémoire tampon d’accumulation

_bit de _ mémoire tampon de couleur GL _

_Bit d’activation du test du GL alpha _

Fonction de test alpha et valeur de référence

Bit d’activation de la _ fusion GL

Fusion des fonctions source et de destination

_Bit d’activation du tramage GL

_Paramètre de _ mémoire tampon de dessin GL

_Bit logique d’activation du GL _

Fonction Logic op

Valeurs claires en mode couleur et en mode index

Writemasks en mode couleur et en mode index

_bit actuel du GL _

Couleur RVBA actuelle

Index des couleurs actuelles

Vecteur normal actuel

Coordonnées de texture actuelles

Position raster actuelle indicateur de _ la _ position raster _ actuelle de la position raster _

Couleur RVBA associée à la position de la trame actuelle

Index de couleurs associé à la position de la trame actuelle

Coordonnées de texture associées à la position de trame actuelle

Indicateur de l’indicateur de périphérie du GL _ _

_bit de _ mémoire tampon de profondeur GL _

_Bit d’activation du test de profondeur du GL _

Fonction de test de la mémoire tampon de profondeur

Valeur effacée de la mémoire tampon de profondeur

Profondeur du GL _ _ WRITEMASK activer le bit

_bit d’activation du GL _

Indicateur de test de comptabilité _ alpha _

_Indicateur de _ normalisation automatique du GL

Indicateur de fusion du GL _

Activer le service bits pour les plans de découpage définissables par l’utilisateur

_matériau de couleur GL _

Indicateur de visage de _ CULLING GL _

Indicateur de test de _ profondeur du GL _

_Indicateur de tramage GL

_Indicateur de brouillard GL

GL _ clair i où 0 <= i < des _ lumières du GL Max _

_Indicateur d’éclairage GL

Indicateur de lissage de _ ligne GL _

_ _ Indicateur STIPPLE de la ligne GL

Indicateur de logique de l' _ op GL couleur _ _

_Indicateur d' _ op logique d’index GL _

GL _ Map1 _ x où x est un type de carte

GL _ map2 _ x où x est un type de carte

_Indicateur de normalisation GL

Indicateur de lissage du _ point GL _

_Indicateur de _ ligne de décalage du polygone GL _

_Indicateur de _ remplissage de décalage de polygone GL _

_Indicateur de _ point de décalage de polygone GL _

_Indicateur de lissage de polygones GL _

_Indicateur de STIPPLE de polygones GL _

Indicateur de test de _ ciseaux du GL _

Indicateur de test de _ stencil du GL _

_ _ Indicateur 1D de la texture GL

_Indicateur de texture GL _ 2D

Flags GL _ texture _ GEN _ x où x est S, T, R ou Q

_bit d’évaluation du GL _

GL _ Map1 _ x active bits, où x est un type de carte

GL _ map2 _ x active bits, où x est un type de carte

points de terminaison de grille 1D et divisions

points de terminaison de grille 2D et divisions

Bit d’activation de la _ normalisation automatique du GL _

_bit de brouillard GL _

_Indicateur d’activation du brouillard GL

Couleur de brouillard

Densité de brouillard

Démarrage du brouillard linéaire

Fin du brouillard linéaire

Index de brouillard

Valeur du mode de _ brouillard GL _

_bit indicateur _ GL

Paramètre de l’indicateur de correction de la _ perspective GL _ _

_Paramètre d' _ indicateur d’arrondi de point GL _

_Paramètre d' _ indicateur de lissage de ligne GL _

_Paramètre d' _ indicateur de lissage de polygones GL _

Paramètre de l' _ indicateur de brouillard GL _

_bit d’éclairage GL _

Bit de couleur GL- _ _ activer le bit

_Valeur de _ face du matériau de couleur GL _

Paramètres de matériau de couleur qui effectuent le suivi de la couleur actuelle

Couleur de scène ambiante

_Valeur de _ la _ visionneuse locale du modèle de lumière GL _

_Paramètre côté « GL Light _ Model _ deux _ côtés »

Bit d’activation de l' _ éclairage GL

Activer le bit pour chaque lumière

Intensité ambiante, diffuse et spéculaire pour chaque lumière

Orientation, position, exposant et angle de coupure pour chaque lumière

Facteurs d’atténuation constante, linéaire et quadratique pour chaque lumière

Couleur ambiante, diffuse, spéculaire et émissif pour chaque matière

Index de couleurs ambiants, diffuses et spéculaires pour chaque matériau

Exposant spéculaire pour chaque paramètre de modèle d' _ ombrage de la comptabilité matières _

_bit de ligne GL _

Indicateur de lissage de _ ligne GL _

Bit de STIPPLE de ligne GL- _ _ activer

Modèle de stipple de ligne et compteur de répétition

Largeur de ligne

_bit de liste GL _

Paramètre de base de la _ liste GL _

_bit du _ mode de pixel GL _

_ _ Paramètres de décalage rouge et _ de _ balance rouge du GL

_ _ Valeurs de l’échelle vert GL et de l' _ échelle verte GL _

_Décalage bleu GL _ et _ échelle bleue _ GL

_Décalage alpha du GL _ et échelle du GL _ alpha _

_ _ Décalage de profondeur GL et _ échelle de profondeur GL _

Décalage de l’index GL _ _ et valeurs de décalage de l' _ index GL _

_Couleurs de la carte GL _ et indicateurs de stencil de la _ carte GL _

_Zooms GL _ X et _ Zoom GL _ Y

Paramètre de tampon de _ lecture GL _

_bit de point GL _

Indicateur de lissage du _ point GL _

Taille du point

_bit de polygone GL _

Bit d’activation de la face de l' _ élimination GL _

_Valeur du _ mode visage d’élimination du GL _

_Indicateur de _ face avant GL

_Paramètre du _ mode polygone GL

_Indicateur de lissage de polygones GL _

STIPPLE de l’activation du polygone de GL _ _

_Indicateur de _ remplissage de décalage de polygone GL _

_Indicateur de _ ligne de décalage du polygone GL _

_Indicateur de _ point de décalage de polygone GL _

_facteur de _ décalage du polygone GL _

_unités de décalage de polygones GL _ _

_STIPPLE- _ _ bit de polygone de GL

Image Polygon stipple

_bit de ciseaux de GL _

Indicateur de test de _ ciseaux du GL _

Zone de ciseaux

_bit de _ tampon de stencil du GL _

_Bit d’activation du test du gabarit GL _

Fonction de stencil et valeur de référence

Masque de valeur de stencil

Actions de réussite de la passe de tampon d’échec, de réussite et de profondeur du stencil

Valeur Clear de la mémoire tampon du stencil

Tampon de stencil writemask

_bit de texture GL _

Activer bits pour les quatre coordonnées de texture

Couleur de la bordure pour chaque image de texture

Fonction minimisation pour chaque image de texture

Fonction d’agrandissement pour chaque image de texture

Coordonnées de texture et mode habillage pour chaque image de texture

Couleur et mode pour chaque environnement de texture

Activer bits GL _ texture _ GEN _ x; x est S, T, R et Q

_ _ _ Paramètre du mode de la génération de texture GL pour S, T, R et Q

équations de plan glTexGen pour S, T, R et Q

_bit de transformation GL _

Coefficients des six plans de découpage

Activer le service bits pour les plans de découpage définissables par l’utilisateur

Valeur du mode de _ matrice GL _

_Indicateur de normalisation GL

_bit de fenêtre d’affichage GL _

Plage de profondeur (proche et loin)

Origine de la fenêtre d’affichage et étendue

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
dépassement de capacité de la _ pile GL _
La fonction a été appelée alors que la pile d’attributs était pleine.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glPushAttrib prend un argument, un masque qui indique les groupes de variables d’État à enregistrer sur la pile d’attributs. Les constantes symboliques sont utilisées pour définir des bits dans le masque. Le paramètre Mask est généralement construit en appliquant l’opération or logique à plusieurs de ces constantes. Vous pouvez utiliser le masque spécial GL _ tous _ les _ bits d’attrib pour enregistrer tous les États empilables.

La fonction glPopAttrib restaure les valeurs des variables d’état enregistrées avec la dernière commande glPushAttrib . Ceux qui ne sont pas enregistrés restent inchangés.

C’est une erreur de transmettre des attributs à une pile complète, ou d’afficher des attributs sur une pile vide. Dans les deux cas, l’indicateur d’erreur est défini et aucune autre modification n’est apportée à l’État OpenGL.

Initialement, la pile d’attributs est vide.

Toutes les valeurs de l’État OpenGL ne peuvent pas être enregistrées dans la pile d’attributs. Par exemple, vous ne pouvez pas enregistrer l’état du Pack de pixels et décompresser, l’état du mode de rendu et l’état de sélection et de commentaires.

La profondeur de la pile d’attributs dépend de l’implémentation, mais elle doit être au moins égale à 16.

Les fonctions suivantes récupèrent les informations relatives à glPushAttrib et glPopAttrib:

glGet avec argument la _ profondeur de la pile GL attrib _ _

glGet avec l’argument GL max. profondeur de la _ _ _ pile _

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

glBegin

glEnd

glGet

glGetClipPlane

glGetError

glGetLight

glGetMap

glGetMaterial

glGetPixelMap

glGetPolygonStipple

glGetString

glGetTexEnv

glGetTexGen

glGetTexImage

glGetTexLevelParameter

glGetTexParameter

glIsEnabled