C
glCallLists
Chapter 3
43
glCallLists
glCallLists: execute a list of display lists.
C Specification
void glCallLists(
GLsizei n,
GLenum type,
const GLvoid *lists)
Parameters
n Specifies the number of display lists to be executed.
type Specifies the type of values in lists. Symbolic constants GL_BYTE,
GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT,
GL_INT, GL_UNSIGNED_INT, GL_FLOAT, GL_2_BYTES,
GL_3_BYTES, and GL_4_BYTES are accepted.
lists Specifies 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.
Description
glCallLists causes each display list in the list of names passed as lists to be executed. As
a result, the commands 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.
glCallLists provides an efficient means for executing more than one display list. type
allows lists with various name formats to be accepted. The formats are as follows:
GL_BYTE lists is treated as an array of signed bytes, each in the range - 128
through 127.
GL_UNSIGNED_BYTE
lists is treated as an array of unsigned bytes, each in the range 0
through 255.
GL_SHORT lists is treated as an array of signed two-byte integers, each in the
range - 32768 through 32767.
GL_UNSIGNED_SHORT
lists is treated as an array of unsigned two-byte integers, each in the
range 0 through 65535.
GL_INT lists is treated as an array of signed four-byte integers.
GL_UNSIGNED_INT
lists is treated as an array of unsigned four-byte integers.
GL_FLOAT lists is treated as an array of four-byte floating-point values.