fglNewList(3G)

NAME
     fglNewList, fglEndList - create or replace a display list


FORTRAN SPECIFICATION
     SUBROUTINE fglNewList( INTEGER*4 list,
                            INTEGER*4 mode )


PARAMETERS
     list  Specifies the display-list name.

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

FORTRAN SPECIFICATION
     SUBROUTINE fglEndList( )


DESCRIPTION
     Display lists are groups of GL commands that have been stored for
     subsequent execution.  Display lists are created with fglNewList.  All
     subsequent commands are placed in the display list, in the order issued,
     until fglEndList is called.

     fglNewList 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 fglGenLists and tested for uniqueness with
     fglIsList.  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
     fglColorPointer, fglDeleteLists, fglDisableClientState,
     fglEdgeFlagPointer, fglEnableClientState, fglFeedbackBuffer, fglFinish,
     fglFlush, fglGenLists, fglIndexPointer, fglInterleavedArrays,
     fglIsEnabled, fglIsList, fglNormalPointer, fglPopClientAttrib,
     fglPixelStore, fglPushClientAttrib, fglReadPixels, fglRenderMode,
     fglSelectBuffer, fglTexCoordPointer, fglVertexPointer, and all of the
     fglGet commands.

     Similarly, fglTexImage2D and fglTexImage1D 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 fglEndList is encountered, the display-list definition is completed
     by associating the list with the unique name list (specified in the
     fglNewList command). If a display list with name list already exists, it
     is replaced only when fglEndList is called.

NOTES
     fglCallList and fglCallLists can be entered into display lists.  Commands
     in the display list or lists executed by fglCallList or fglCallLists 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 created in GL_COMPILE mode, errors are not
     generated 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 fglEndList is called without a
     preceding fglNewList, or if fglNewList is called while a display list is
     being defined.

     GL_INVALID_OPERATION is generated if fglNewList or fglEndList is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.

     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
     fglIsList
     fglGet with argument GL_LIST_INDEX
     fglGet with argument GL_LIST_MODE


SEE ALSO
     fglCallList, fglCallLists, fglDeleteLists, fglGenLists