Unix/Linux Go Back    


SuSE 11.3 - man page for glendlist (suse section 3G)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


GLNEWLIST(3G)									    GLNEWLIST(3G)

NAME
       glNewList, glEndList - create or replace a display list

C SPECIFICATION
       void glNewList( GLuint list,
		       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 glEndList( void )

DESCRIPTION
       Display	lists  are  groups of GL commands that have been stored for subsequent execution.
       Display lists are created with glNewList.  All subsequent commands are placed in the  dis-
       play 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 con-
       stant 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 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, 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  com-
       piled into display lists, but executed immediately.

       When glEndList is encountered, the display-list definition is completed 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.  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  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 executed between the execu-
       tion 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(3G), glCallLists(3G), glDeleteLists(3G), glGenLists(3G)

										    GLNEWLIST(3G)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:26 AM.