1GLCALLLISTS(3G)                  OpenGL Manual                 GLCALLLISTS(3G)
2
3
4

NAME

6       glCallLists - execute a list of display lists
7

C SPECIFICATION

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

PARAMETERS

12       n
13           Specifies the number of display lists to be executed.
14
15       type
16           Specifies the type of values in lists. Symbolic constants GL_BYTE,
17           GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT,
18           GL_UNSIGNED_INT, GL_FLOAT, GL_2_BYTES, GL_3_BYTES, and GL_4_BYTES
19           are accepted.
20
21       lists
22           Specifies the address of an array of name offsets in the display
23           list. The pointer type is void because the offsets can be bytes,
24           shorts, ints, or floats, depending on the value of type.
25

DESCRIPTION

27       glCallLists causes each display list in the list of names passed as
28       lists to be executed. As a result, the commands saved in each display
29       list are executed in order, just as if they were called without using a
30       display list. Names of display lists that have not been defined are
31       ignored.
32
33       glCallLists provides an efficient means for executing more than one
34       display list.  type allows lists with various name formats to be
35       accepted. The formats are as follows:
36
37       GL_BYTE
38           lists is treated as an array of signed bytes, each in the range
39           -128 through 127.
40
41       GL_UNSIGNED_BYTE
42           lists is treated as an array of unsigned bytes, each in the range 0
43           through 255.
44
45       GL_SHORT
46           lists is treated as an array of signed two-byte integers, each in
47           the range -32768 through 32767.
48
49       GL_UNSIGNED_SHORT
50           lists is treated as an array of unsigned two-byte integers, each in
51           the range 0 through 65535.
52
53       GL_INT
54           lists is treated as an array of signed four-byte integers.
55
56       GL_UNSIGNED_INT
57           lists is treated as an array of unsigned four-byte integers.
58
59       GL_FLOAT
60           lists is treated as an array of four-byte floating-point values.
61
62       GL_2_BYTES
63           lists is treated as an array of unsigned bytes. Each pair of bytes
64           specifies a single display-list name. The value of the pair is
65           computed as 256 times the unsigned value of the first byte plus the
66           unsigned value of the second byte.
67
68       GL_3_BYTES
69           lists is treated as an array of unsigned bytes. Each triplet of
70           bytes specifies a single display-list name. The value of the
71           triplet is computed as 65536 times the unsigned value of the first
72           byte, plus 256 times the unsigned value of the second byte, plus
73           the unsigned value of the third byte.
74
75       GL_4_BYTES
76           lists is treated as an array of unsigned bytes. Each quadruplet of
77           bytes specifies a single display-list name. The value of the
78           quadruplet is computed as 16777216 times the unsigned value of the
79           first byte, plus 65536 times the unsigned value of the second byte,
80           plus 256 times the unsigned value of the third byte, plus the
81           unsigned value of the fourth byte.
82
83       The list of display-list names is not null-terminated. Rather, n
84       specifies how many names are to be taken from lists.
85
86       An additional level of indirection is made available with the
87       glListBase() command, which specifies an unsigned offset that is added
88       to each display-list name specified in lists before that display list
89       is executed.
90
91       glCallLists can appear inside a display list. To avoid the possibility
92       of infinite recursion resulting from display lists calling one another,
93       a limit is placed on the nesting level of display lists during
94       display-list execution. This limit must be at least 64, and it depends
95       on the implementation.
96
97       GL state is not saved and restored across a call to glCallLists. Thus,
98       changes made to GL state during the execution of the display lists
99       remain after execution is completed. Use glPushAttrib(), glPopAttrib(),
100       glPushMatrix(), and glPopMatrix() to preserve GL state across
101       glCallLists calls.
102

NOTES

104       Display lists can be executed between a call to glBegin() and the
105       corresponding call to glEnd(), as long as the display list includes
106       only commands that are allowed in this interval.
107

ERRORS

109       GL_INVALID_VALUE is generated if n is negative.
110
111       GL_INVALID_ENUM is generated if type is not one of GL_BYTE,
112       GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT,
113       GL_FLOAT, GL_2_BYTES, GL_3_BYTES, GL_4_BYTES.
114

ASSOCIATED GETS

116       glGet() with argument GL_LIST_BASE
117
118       glGet() with argument GL_MAX_LIST_NESTING
119
120       glIsList()
121

SEE ALSO

123       glCallList(), glDeleteLists(), glGenLists(), glListBase(), glNewList(),
124       glPushAttrib(), glPushMatrix()
125

127       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
128       under the SGI Free Software B License. For details, see
129       http://oss.sgi.com/projects/FreeB/.
130

AUTHORS

132       opengl.org
133
134
135
136opengl.org                        06/10/2014                   GLCALLLISTS(3G)
Impressum