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 |
|---|---|
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|