glCallLists

  • Article

The glCallLists function executes a list of display lists.

void glCallLists(
  GLsizei n,  GLenum type,  const GLvoid *lists);

Parameters

  • n
    The number of display lists to be executed.

  • type
    The type of values in lists. The following symbolic constants are accepted:

    Value Description
    GL_BYTE The lists parameter is treated as an array of signed bytes, each in the range 128 through 127.
    GL_UNSIGNED_BYTE The lists parameter is treated as an array of unsigned bytes, each in the range 0 through 255.
    GL_SHORT The lists parameter is treated as an array of signed 2-byte integers, each in the range 32768 through 32767.
    GL_UNSIGNED_SHORT The lists parameter is treated as an array of unsigned 2-byte integers, each in the range 0 through 65535.
    GL_INT The lists parameter is treated as an array of signed 4-byte integers.
    GL_UNSIGNED_INT The lists parameter is treated as an array of unsigned 4-byte integers.
    GL_FLOAT The lists parameter is treated as an array of 4-byte, floating-point values.
    GL_2_BYTES The lists parameter is treated as an array of unsigned bytes. Each pair of bytes specifies a single display-list name. The value of the pair is computed as 256 times the unsigned value of the first byte plus the unsigned value of the second byte.
    GL_3_BYTES The lists parameter is treated as an array of unsigned bytes. Each triplet of bytes specifies a single display list name. The value of the triplet is computed as 65536 times the unsigned value of the first byte, plus 256 times the unsigned value of the second byte, plus the unsigned value of the third byte.
    GL_4_BYTES The lists parameter is treated as an array of unsigned bytes. Each quadruplet of bytes specifies a single display list name. The value of the quadruplet is computed as 16777216 times the unsigned value of the first byte, plus 65536 times the unsigned value of the second byte, plus 256 times the unsigned value of the third byte, plus the unsigned value of the fourth byte.

  • lists
    The address of an array of name offsets in the display list. The pointer type is void because the offsets can be bytes, shorts, ints, or floats, depending on the value of type.

Remarks

The glCallLists function causes each display list in the list of names passed as lists to be executed. As a result, the functions saved in each display list are executed in order, just as if they were called without using a display list. Names of display lists that have not been defined are ignored.

The glCallLists function provides an efficient means for executing display lists.The n parameter specifies the number of lists with various name formats (specified by the type parameter) glCallLists executes.

The list of display list names is not null-terminated. Rather, n specifies how many names are to be taken from lists.

The glListBase function makes an additional level of indirection available. The glListBase function specifies an unsigned offset that is added to each display list name specified in lists before that display list is executed.

The glCallLists function 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 must be at least 64, and it depends on the implementation.

The OpenGL state is not saved and restored across a call to glCallLists. Thus, changes made to the OpenGL state during the execution of the display lists remain after execution is completed. Use glPushAttrib, glPopAttrib, glPushMatrix, and glPopMatrix to preserve the OpenGL state across glCallLists calls.

You can execute display lists between a call to glBegin and the corresponding call to glEnd, as long as the display list includes only functions that are allowed in this interval.

The following functions retrieve information related to the glCallLists function:

glGet with argument GL_LIST_BASE

glGet with argument GL_MAX_LIST_NESTING

glIsList

Requirements

**  Windows NT/2000:** Requires Windows NT 3.5 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Declared in Gl.h.
**  Library:** Use Opengl32.lib.

See Also

glBegin, glCallList, glDeleteLists, glEnd, glGenLists, glGet, glIsList, glListBase, glNewList, glPopAttrib, glPopMatrix, glPushAttrib, glPushMatrix