[ Previous | Next | Contents | Glossary | Home | Search ]
OpenGL 1.1 for AIX: Reference Manual

glCallList Subroutine


Executes a display list.


OpenGL C bindings library: libGL.a

C Syntax

void glCallList(GLuint List)


List Specifies the integer name of the display list to be executed.


The glCallList subroutine causes the named display list to be executed. The subroutines 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.

The glCallList subroutine may appear inside a display list. To avoid the possibility of infinite recursion resulting from display lists calling one another, an implementation-dependent limit is placed on the the nesting level of display lists during display list execution. This limit is at least 64.

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 will remain after execution of the display list is completed. Use the glPushAttrib, glPopAttrib, PushMatrix, and glPopMatrix subroutines to preserve GL state across glCallList calls.


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

The associated get for the glCallList subroutine is as follows. (See the glGet subroutine for more information.)

glGet with argument GL_MAX_LIST_NESTING



/usr/include/GL/gl.h Contains C language constants, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The glBegin or glEnd subroutine, glCallLists subroutine, glDeleteLists subroutine, glGenLists subroutine, glNewList subroutine, glPushAttrib or glPopAttrib subroutine, glPushMatrix or glPopMatrix subroutine.

OpenGL Overview.

[ Previous | Next | Contents | Glossary | Home | Search ]