GLCALLLIST() MachTen Programmer’s Manual GLCALLLIST()

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 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 glCal-
lList. Thus, changes made to GL state during the execu-
tion of a display list remain after execution of the dis-
play 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

MachTen 1