Display lists are groups of GL commands that have been stored
for subsequent execution.
Display lists are created with GL.glNewList.
All subsequent commands are placed in the display list,
in the order issued,
until GL.glEndList is called.
GL.glNewList has two arguments.
The first argument,
list,
is a positive integer that becomes the unique name for the display list.
Names can be created and reserved with GL.glGenLists
and tested for uniqueness with GL.glIsList.
The second argument,
mode,
is a symbolic constant that can assume one of two values:
| GL_COMPILE
| Commands are merely compiled.
|
| GL_COMPILE_AND_EXECUTE
| Commands are executed as they are compiled into the display list.
|
|
Certain commands are not compiled into the display list
but are executed immediately,
regardless of the display-list mode.
These commands are
glColorPointer,
GL.glDeleteLists,
GL.glDisableClientState,
glEdgeFlagPointer,
GL.glEnableClientState,
glFeedbackBuffer,
GL.glFinish,
GL.glFlush,
GL.glGenLists,
glIndexPointer,
glInterleavedArrays,
GL.glIsEnabled,
GL.glIsList,
glNormalPointer,
GL.glPopClientAttrib,
glPixelStore,
GL.glPushClientAttrib,
glReadPixels,
GL.glRenderMode,
glSelectBuffer,
glTexCoordPointer,
glVertexPointer,
and all of the glGet commands.
Similarly,
GL.glTexImage2D and glTexImage1D
are executed immediately and not compiled into the display list when their
first argument is GL_PROXY_TEXTURE_2D or
GL_PROXY_TEXTURE_1D, respectively.
When GL.glEndList is encountered,
the display-list definition is completed by associating the list
with the unique name list
(specified in the GL.glNewList command).
If a display list with name list already exists,
it is replaced only when GL.glEndList is called.
GL.glEnd()