Función glPushClientAttrib

Las funciones glPushClientAttrib y glPopClientAttrib guardan y restauran grupos de variables de estado de cliente en la pila de atributos de cliente.

Sintaxis

void WINAPI glPushClientAttrib(
   GLbitfield mask
);

Parámetros

mask

Máscara que indica qué atributos se van a guardar. A continuación se muestran las constantes de máscara simbólica y sus estados de cliente openGL asociados.

Value	Significado
GL_CLIENT_PIXEL_STORE_BIT	Atributos del modo de almacenamiento de píxeles.
GL_CLIENT_VERTEX_ARRAY_BIT	Atributos de matriz de vértices.
GL_CLIENT_ALL_ATTRIB_BITs	todos los atributos de estado de cliente apilables.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar el siguiente código de error.

Nombre	Significado
GL_STACK_OVERFLOW	Se llamó a la función mientras la pila de atributos de cliente estaba llena.

Comentarios

La función glPushClientAttrib usa su parámetro mask para determinar qué grupos de variables de estado de cliente se guardan en la pila de atributos de cliente. Puede usar el operador OR bit a bit para combinar constantes simbólicas aceptadas para establecer bits y construir una máscara.

La función glPopClientAttrib restaura los valores de las variables de estado de cliente guardadas por última vez con glPushclientAttrib. Las variables de estado de cliente que no se guardaron previamente se dejan sin cambios. Insertar atributos en una pila completa de atributos de cliente o extraer atributos de una pila vacía establece una marca de error y no se realiza ningún otro cambio en el estado openGL. De forma predeterminada, la pila de atributos de cliente está vacía.

Algunos valores de estado de cliente de OpenGL no se pueden guardar en la pila de atributos de cliente. Por ejemplo, no puede guardar los estados de selección o comentarios en la pila de atributos de cliente. La profundidad de la pila de atributos de cliente es de al menos 16.

Las funciones glPushclientAttrib y glPopClientAttrib no se compilan en listas para mostrar, pero se ejecutan inmediatamente.

Las funciones glPushClientAttrib y glPopClientAttrib solo pueden insertar y pop los modos de almacenamiento de píxeles y los estados de cliente de matriz de vértices. Debe usar glPushAttrib y glPopAttrib para insertar y pop los estados que se mantienen en el servidor.

Nota

Las funciones glPushClientAttrib y glPopClientAttrib solo están disponibles en OpenGL versión 1.1 o posterior.

Las siguientes funciones recuperan información relacionada con glPushClientAttrib y glPopClientAttrib:

glGet con GL_CLIENT_ATTRIB_STACK_DEPTH de argumentos

glGet con GL_MAX_CLIENT_ATTRIB_STACK_DEPTH de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glColorPointer

glDisableClientState

glEdgeFlagPointer

glEnableClientState

glGet

glGetError

glIndexPointer

glNormalPointer

glNewList

glPixelStore

glPushAttrib

glTexCoordPointer

glVertexPointer