1991-2006
Silicon Graphics, Inc.
glCallList
3G

# 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

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.