glNewList man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

glNewList(3G)							 glNewList(3G)

NAME
       glNewList, glEndList - create or replace a display list

SYNOPSIS
       void glNewList(
	       void ); void glEndList(
	       void );

PARAMETERS
       Specifies the display-list name.	 Specifies the compilation mode, which
       can be GL_COMPILE or GL_COMPILE_AND_EXECUTE.

DESCRIPTION
       Display lists are groups of GL commands that have been stored for  sub‐
       sequent	execution.  Display  lists  are created 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, 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: Commands are merely compiled.  Commands are
       executed as they are compiled into the display list.

       Certain commands are not compiled into the display list	but  are  exe‐
       cuted  immediately, regardless of the display-list mode. These commands
       are   glAreTexturesResident(),	 glColorPointer(),    glDeleteLists(),
       glDeleteTextures(),  glDisableClientState(), glEdgeFlagPointer(), glEn‐
       ableClientState(), glFeedbackBuffer(),  glFinish(),  glFlush(),	glGen‐
       Lists(),	  glGenTextures(),   glIndexPointer(),	glInterleavedArrays(),
       glIsEnabled(),  glIsList(),  glIsTexture(),  glNormalPointer(),	glPop‐
       ClientAttrib(),	glPixelStore(),	 glPushClientAttrib(), glReadPixels(),
       glRenderMode(),	 glSelectBuffer(),   glTexCoordPointer(),    glVertex‐
       Pointer(), and all of the glGet() commands.

       Similarly,  glTexImage1D(), glTexImage2D(), and glTexImage3D() are exe‐
       cuted 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 GL_PROXY_HISTOGRAM.  Similarly, glCol‐
       orTable()   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, glClientActiveTex‐
       tureARB() is not compiled into display lists, but executed immediately.

       When  glEndList()  is  encountered, the display-list definition is com‐
       pleted by associating the list with the unique name list (specified  in
       the  glNewList()	 command).   If	 a display list with name list already
       exists, it is replaced only when glEndList() is called.

NOTES
       glCallList() and glCallLists() can be entered into display lists.  Com‐
       mands  in the display list or lists executed by glCallList() or glCall‐
       Lists() 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 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 exe‐
       cuted  between  the execution of glBegin() and the corresponding execu‐
       tion of glEnd().

       GL_OUT_OF_MEMORY is generated if there is insufficient memory  to  com‐
       pile  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(3), glCallLists(3), glDeleteLists(3), glGenLists(3)

								 glNewList(3G)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net