'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.1.0
.ds Dp Mar 17 18:03
.ds Dm  Mar  6 20:0
.ds Xs 4180 3 calllist.gl
.TH GLCALLLIST
.SH NAME
.B "glCallList
\- execute a display list

.SH C SPECIFICATION
void \f3glCallList\fP(
GLuint \fIlist\fP )
.nf
.fi

.SH PARAMETERS
.TP \w'\f2list\fP\ \ 'u 
\f2list\fP
Specifies the integer name of the display list to be executed.
.SH DESCRIPTION
\f3glCallList\fP 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 \f2list\fP has not been defined as a display list,
\f3glCallList\fP is ignored.
.P
\f3glCallList\fP 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.
.P
GL state is not saved and restored across a call to \f3glCallList\fP.
Thus,
changes made to GL state during the execution of a display list
remain after execution of the display list is completed.
Use \f3glPushAttrib\fP,
\f3glPopAttrib\fP,
\f3glPushMatrix\fP,
and \f3glPopMatrix\fP to preserve GL state across \f3glCallList\fP calls.
.SH NOTES
Display lists can be executed between a call to \f3glBegin\fP
and the corresponding call to \f3glEnd\fP,
as long as the display list includes only commands that are allowed
in this interval.
.SH ASSOCIATED GETS
\f3glGet\fP with argument \f3GL_MAX_LIST_NESTING\fP
.br
\f3glIsList\fP
.SH SEE ALSO
\f3glCallLists\fP,
\f3glDeleteLists\fP,
\f3glGenLists\fP,
\f3glNewList\fP,
\f3glPushAttrib\fP, 
\f3glPushMatrix\fP