NAME

glCallLists - execute a list of display lists

C SPECIFICATION

void ggllCCaallllLLiissttss( GLsizei _n,
                  GLenum _t_y_p_e,
                  const GLvoid _*_l_i_s_t_s )

PARAMETERS

_n
Specifies the number of display lists to be executed.
_t_y_p_e
Specifies the type of values in _l_i_s_t_s. Symbolic constants GGLL__BBYYTTEE, GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE, GGLL__SSHHOORRTT, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT, GGLL__IINNTT, GGLL__UUNNSSIIGGNNEEDD__IINNTT, GGLL__FFLLOOAATT, GGLL__22__BBYYTTEESS, GGLL__33__BBYYTTEESS, and GGLL__44__BBYYTTEESS are accepted.
_l_i_s_t_s
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 _t_y_p_e.

DESCRIPTION

ggllCCaallllLLiissttss causes each display list in the list of names passed as _l_i_s_t_s 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.

ggllCCaallllLLiissttss provides an efficient means for executing more than one display list. _t_y_p_e allows lists with various name formats to be accepted. The formats are as follows:

GGLL__BBYYTTEE
_l_i_s_t_s is treated as an array of signed bytes, each in the range -128 through 127.
GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE
_l_i_s_t_s is treated as an array of unsigned bytes, each in the range 0 through 255.
GGLL__SSHHOORRTT
_l_i_s_t_s is treated as an array of signed two-byte integers, each in the range -32768 through 32767.
GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT
_l_i_s_t_s is treated as an array of unsigned two-byte integers, each in the range 0 through 65535.
GGLL__IINNTT
_l_i_s_t_s is treated as an array of signed four-byte integers.
GGLL__UUNNSSIIGGNNEEDD__IINNTT
_l_i_s_t_s is treated as an array of unsigned four-byte integers.
GGLL__FFLLOOAATT
_l_i_s_t_s is treated as an array of four-byte floating-point values.
GGLL__22__BBYYTTEESS
_l_i_s_t_s 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.
GGLL__33__BBYYTTEESS
_l_i_s_t_s 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.
GGLL__44__BBYYTTEESS
_l_i_s_t_s 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.

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

An additional level of indirection is made available with the ggllLLiissttBBaassee command, which specifies an unsigned offset that is added to each display-list name specified in _l_i_s_t_s before that display list is executed.

ggllCCaallllLLiissttss 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.

GL state is not saved and restored across a call to ggllCCaallllLLiissttss. Thus, changes made to GL state during the execution of the display lists remain after execution is completed. Use ggllPPuusshhAAttttrriibb, ggllPPooppAAttttrriibb, ggllPPuusshhMMaattrriixx, and ggllPPooppMMaattrriixx to preserve GL state across ggllCCaallllLLiissttss calls.

NOTES

Display lists can be executed between a call to ggllBBeeggiinn and the corresponding call to ggllEEnndd, as long as the display list includes only commands that are allowed in this interval.

ERRORS

GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if _n is negative.

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _t_y_p_e is not one of GGLL__BBYYTTEE, GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE, GGLL__SSHHOORRTT, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT, GGLL__IINNTT, GGLL__UUNNSSIIGGNNEEDD__IINNTT, GGLL__FFLLOOAATT, GGLL__22__BBYYTTEESS, GGLL__33__BBYYTTEESS, GGLL__44__BBYYTTEESS.

ASSOCIATED GETS

ggllGGeett with argument GGLL__LLIISSTT__BBAASSEE
ggllGGeett with argument GGLL__MMAAXX__LLIISSTT__NNEESSTTIINNGG
ggllIIssLLiisstt

SEE ALSO

ggllCCaallllLLiisstt((33GG)), ggllDDeelleetteeLLiissttss((33GG)), ggllGGeennLLiissttss((33GG)), ggllLLiissttBBaassee((33GG)), ggllNNeewwLLiisstt((33GG)), ggllPPuusshhAAttttrriibb((33GG)),
ggllPPuusshhMMaattrriixx((33GG))