GLCALLLISTS - Online Linux Manual PageSection : 3G

NAME"glCallLists − execute a list of display lists

C SPECIFICATIONvoid glCallLists( GLsizei n, GLenum type, const GLvoid *lists )

PARAMETERSn  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. ­GL_2_BYTES  lists 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  lists 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  lists 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 lists. An additional level of indirection is made available with the ­glListBase command, which specifies an unsigned offset that is added to each display-list name specified in lists before that display list is executed. ­glCallLists 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 ­glCallLists. Thus, changes made to GL state during the execution of the display lists remain after execution is completed. Use ­glPushAttrib, ­glPopAttrib, ­glPushMatrix, and ­glPopMatrix to preserve GL state across ­glCallLists calls.

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

ERRORS­GL_INVALID_VALUE is generated if n is negative. ­GL_INVALID_ENUM is generated if type is not one of ­GL_BYTE, ­GL_UNSIGNED_BYTE, ­GL_SHORT, ­GL_UNSIGNED_SHORT, ­GL_INT, ­GL_UNSIGNED_INT, ­GL_FLOAT, ­GL_2_BYTES, ­GL_3_BYTES, ­GL_4_BYTES.

ASSOCIATED GETS­glGet with argument ­GL_LIST_BASE
­
glGet with argument ­GL_MAX_LIST_NESTING
­
glIsList

SEE ALSO­glCallList(3G), ­glDeleteLists(3G), ­glGenLists(3G), ­glListBase(3G), ­glNewList(3G), ­glPushAttrib(3G),
­
glPushMatrix(3G)
0
Johanes Gumabo
Data Size   :   17,293 byte
man-glCallLists.3glBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 200,102
Visitor ID   :     :  
Visitor IP   :   3.142.172.250   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.