- execute a display list



C SPECIFICATION


PARAMETERS

       _param1  Specifies the integer name of the display list to
                be executed.


DESCRIPTION

       glCallList causes the named display list to  be  executed.
       The  commands  saved  in  the display list are executed in
       order, just as if they were called without using a display
       list.   If _param1 has not been defined as a display list,
       glCallList is ignored.

       glCallList can appear inside a display list.  To avoid the
       possibility  of  infinite recursion resulting from display
       lists calling one another, a limit is placed on the  nest-
       ing  level of display lists during display-list execution.
       This limit is at least 64, and it depends on the implemen-
       tation.

       GL  state  is  not  saved  and  restored  across a call to
       glCallList.  Thus, changes made to  GL  state  during  the
       execution  of a display list remain after execution of the
       display list is completed.  Use glPushAttrib, glPopAttrib,
       glPushMatrix,  and glPopMatrix to preserve GL state across
       glCallList calls.


NOTES

       Display lists can be executed between a  call  to  glBegin
       and  the  corresponding call to glEnd, as long as the dis-
       play list includes only commands that are allowed in  this
       interval.


ASSOCIATED GETS

       glGet with argument GL_MAX_LIST_NESTING
       glIsList


SEE ALSO

       glCallLists,    glDeleteLists,    glGenLists,   glNewList,
       glPushAttrib, glPushMatrix



                                                                1