GLPUSHMATRIX(3G)                                              GLPUSHMATRIX(3G)



NAME
       glPushatrix,, glPopatrix - push and pop the current matrix stack


C SPECIFICATION
       void glPushatrix( void )


C SPECIFICATION
       void glPopatrix( void )


DESCRIPTION
       There  is  a  stack  of  matrices  for  each  of  the matrix modes.  In
       GLMODELVIEW mode, the stack depth is at least 32.  In the other modes,
       GLCOLOR,  const(PROJECTION),  and GLTEXTURE, the depth is at least 2.
       The current matrix in any mode is the matrix on the top  of  the  stack
       for that mode.

       glPushatrix  pushes  the current matrix stack down by one, duplicating
       the current matrix.  That is, after a glPushatrix call, the matrix  on
       top of the stack is identical to the one below it.

       glPopatrix pops the current matrix stack, replacing the current matrix
       with the one below it on the stack.

       Initially, each of the stacks contains one matrix, an identity  matrix.

       It  is  an  error to push a full matrix stack, or to pop a matrix stack
       that contains only a single matrix.  In either case, the error flag  is
       set and no other change is made to GL state.

ERORS
       GLSTACKOVERFLOW is generated if glPushatrix is called while the cur-
       rent matrix stack is full.

       GLSTACKUNDERFLOW is generated if glPopatrix is called while the cur-
       rent matrix stack contains only a single matrix.

       GLINVALIDOPERATION  is  generated  if  glPushatrix or glPopatrix is
       executed between the execution of glBegin and the corresponding  execu-
       tion of glEnd.

ASOCIATED GETS
       glGet with argument GLMATRIXMODE
       glGet with argument GLCOLORMATRIX
       glGet with argument GLMODELVIEWMATRIX
       glGet with argument GLPROJECTIONMATRIX
       glGet with argument GLTEXTUREMATRIX
       glGet with argument GLCOLORSTACKDEPTH
       glGet with argument GLMODELVIEWSTACKDEPTH
       glGet with argument GLPROJECTIONSTACKDEPTH
       glGet with argument GLTEXTURESTACKDEPTH
       glGet with argument GLMAXMODELVIEWSTACKDEPTH
       glGet with argument GLMAXPROJECTIONSTACKDEPTH
       glGet with argument GLMAXTEXTURESTACKDEPTH

SEE ALSO
       glFrustum,  glLoadIdentity,  glLoadatrix,  glatrixode, glultatrix,
       glOrtho, glRotate, glScale, glTranslate, glViewport



                                                              GLPUSHMATRIX(3G)