GLPUSHCLIENTATRIB(3G)                                  GLPUSHCLIENTATRIB(3G)



NAME
       glPushClientAttrib,,   glPopClientAttrib  -  push  and  pop  the  client
       attribute stack


C SPECIFICATION
       void glPushClientAttrib( GLbitfield mask )


PARAMETERS
       mask  Specifies a mask that indicates which attributes to save.  Values
             for mask are listed below.

C SPECIFICATION
       void glPopClientAttrib( void )


DESCRIPTION
       glPushClientAttrib  takes  one  argument,  a  mask that indicates which
       groups of client-state variables to save on the client attribute stack.
       Symbolic constants are used to set bits in the mask.  mask is typically
       constructed by OR'ing several of these constants together.  The special
       mask GLCLIENTALATRIBITS can be used to save all stackable client
       state.

       The symbolic mask constants and their associated GL client state are as
       follows (the second column lists which attributes are saved):

       GLCLIENTPIXELSTOREBIT     Pixel storage modes
       GLCLIENTVERTEXARAYBIT    Vertex arrays (and enables)

       glPopClientAttrib  restores  the  values  of the client-state variables
       saved with the last  glPushClientAttrib.   Those  not  saved  are  left
       unchanged.

       It  is  an error to push attributes onto a full client attribute stack,
       or to pop attributes off an empty stack.  In  either  case,  the  error
       flag is set, and no other change is made to GL state.

       Initially, the client attribute stack is empty.

NOTES
       glPushClientAttrib  is  available  only  if  the  GL  version is 1.1 or
       greater.

       Not all values for GL client state can be saved on the attribute stack.
       For example, select and feedback state cannot be saved.

       The  depth of the attribute stack depends on the implementation, but it
       must be at least 16.

       Use glPushAttrib and glPopAttrib to push and  restore  state  which  is
       kept on the server. Only pixel storage modes and vertex array state may
       be pushed and popped with glPushClientAttrib and glPopClientAttrib.

       When the GLARBmultitexture extension is supported, pushing  and  pop-
       ping  client  vertex array state apples to all supported texture units,
       and the active client texture state.

ERORS
       GLSTACKOVERFLOW is generated if glPushClientAttrib  is  called  while
       the attribute stack is full.

       GLSTACKUNDERFLOW  is  generated  if glPopClientAttrib is called while
       the attribute stack is empty.

ASOCIATED GETS
       glGet with argument GLATRIBSTACKDEPTH
       glGet with argument GLMAXCLIENTATRIBSTACKDEPTH

SEE ALSO
       glColorPointer,        glDisableClientState,         glEdgeFlagPointer,
       glEnableClientState,       glGet,      glGetError,      glIndexPointer,
       glNormalPointer,      glNewList,      glPixelStore,       glPushAttrib,
       glTexCoordPointer, glVertexPointer



                                                        GLPUSHCLIENTATRIB(3G)