glCallList.3gl








Name


  glCallList - execute a display list





C Specification


  void glCallList( GLuint list )





Parameters




  list	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 list	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 nesting level of display lists	during display-list

  execution.  This limit is at least 64, and it	depends	on the

  implementation.



  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 display 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








Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV