- create or replace a display list



C SPECIFICATION


PARAMETERS

       _param1  Specifies the display-list name.

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


C SPECIFICATION


DESCRIPTION

       Display lists are groups of GL  commands  that  have  been
       stored  for  subsequent execution.  Display lists are cre-
       ated with glNewList.  All subsequent commands  are  placed
       in  the display list, in the order issued, until glEndList
       is called.

       glNewList  has  two  arguments.    The   first   argument,
       _param1(1),  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, _param2(1), is a  symbolic
       constant that can assume one of two values:

       GL_COMPILE                    Commands   are  merely  com-
                                     piled.

       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 immediately and not compiled into the display
       list  when  their  first  argument 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  immediately  when  its  argument  is


NOTES

       glCallList and glCallLists can  be  entered  into  display
       lists.   Commands in the display list or lists executed by
       glCallList or glCallLists are not included in the  display
       list  being  created,  even  if  the list creation mode is
       GL_COMPILE_AND_EXECUTE.

       A display list is just a group of commands and  arguments,
       so  errors generated by commands in a display list must be
       generated when the list is executed. If the list  is  cre-
       ated  in  GL_COMPILE  mode, errors are not generated until
       the list is executed.


ERRORS

       GL_INVALID_VALUE is generated if _param1(1) is 0.

       GL_INVALID_ENUM is  generated  if  _param2(1)  is  not  an
       accepted value.

       GL_INVALID_OPERATION  is  generated if glEndList is called
       without a preceding glNewList, or if glNewList  is  called
       while a display list is being 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



                                                                1