GLenum mode )

PARAMETERS
       list  Specifies the display-list name.

       mode  Specifies  the  compilation  mode,  which  can  be  GL_COMPILE  or
             GL_COMPILE_AND_EXECUTE.

C SPECIFICATION
       void GLAPIENTRY glEndList( void )

DESCRIPTION
       Display lists are groups of GL commands that have been stored for subse‐
       quent  execution.  Display lists are created with glNewList.  All subse‐
       quent commands are placed in the display list, in the order issued,  un‐
       til glEndList is called.

       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  glGenLists  and tested for uniqueness with
       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
       glAreTexturesResident, glColorPointer, glDeleteLists,  glDeleteTextures,
       glDisableClientState,       glEdgeFlagPointer,      glEnableClientState,
       glFeedbackBuffer,   glFinish,   glFlush,   glGenLists,    glGenTextures,
       glIndexPointer, glInterleavedArrays, glIsEnabled, glIsList, glIsTexture,
       glNormalPointer,  glPopClientAttrib,  glPixelStore,  glPushClientAttrib,
       glReadPixels,     glRenderMode,    glSelectBuffer,    glTexCoordPointer,
       glVertexPointer, and all of the glGet commands.

       Similarly, glTexImage1D, glTexImage2D, and glTexImage3D are executed im‐
       mediately  and not compiled into the display list when their first argu‐
       ment      is      GL_PROXY_TEXTURE_1D,      GL_PROXY_TEXTURE_1D,      or
       GL_PROXY_TEXTURE_3D, respectively.

       When the GL_ARB_imaging extension is supported, glHistogram executes im‐
       mediately  when  its   argument   is   GL_PROXY_HISTOGRAM.    Similarly,
       glColorTable   executes   immediately   when   its   first  argument  is
       glPROXY_COLOR_TABLE,      glPROXY_POST_CONVOLUTION_COLOR_TABLE,       or
       glPROXY_POST_COLOR_MATRIX_COLOR_TABLE.

       When     the     GL_ARB_multitexture     extension     is     supported,
       glClientActiveTextureARB is not compiled into display  lists,  but  exe‐
       cuted immediately.
       executed. If the list is created in GL_COMPILE mode, errors are not gen‐
       erated until the list is executed.

ERRORS
       GL_INVALID_VALUE is generated if list is 0.

       GL_INVALID_ENUM is generated if mode is not an accepted value.

       GL_INVALID_OPERATION is generated if glEndList is called without a  pre‐
       ceding  glNewList, or if glNewList is called while a display list is be‐
       ing defined.

       GL_INVALID_OPERATION is generated if glNewList or glEndList is  executed
       between  the  execution  of  glBegin  and the corresponding execution of
       glEnd.

       GL_OUT_OF_MEMORY is generated if there is insufficient memory to compile
       the display list. If the GL version is 1.1 or greater, no change is made
       to the previous contents of the display  list,  if  any,  and  no  other
       change is made to the GL state. (It is as if no attempt had been made to
       create the new display list.)

ASSOCIATED GETS
       glIsList
       glGet with argument GL_LIST_INDEX
       glGet with argument GL_LIST_MODE

SEE ALSO
       glCallList, glCallLists, glDeleteLists, glGenLists

                                                                  GLNEWLIST(3G)