glCallList
Prev | GL | Next

## Name

glCallList — execute a display list

## C Specification

`void `glCallList`` | `(` | `GLuint `list`);`

## Python Specification

``glCallList`` | `(` | ``list`) → `None``

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

Prev | Up | Next
glBlendFunc | Home | glCallLists