*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> OpenGL/glnewlist (3)              


glNewList(3G)		       OpenGL Reference			 glNewList(3G)

NAME    [Toc]    [Back]

     glNewList,	glEndList - create or replace a	display	list

C SPECIFICATION    [Toc]    [Back]

     void glNewList( GLuint list,
		     GLenum mode )

PARAMETERS    [Toc]    [Back]

     list  Specifies the display-list name.

     mode  Specifies the compilation mode, which can be	GL_COMPILE or

C SPECIFICATION    [Toc]    [Back]

     void glEndList( void )

DESCRIPTION    [Toc]    [Back]

     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 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:

     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.

									Page 1

glNewList(3G)		       OpenGL Reference			 glNewList(3G)

     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

     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    [Toc]    [Back]

     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

     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    [Toc]    [Back]

     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 execution of glBegin and the corresponding execution of

     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    [Toc]    [Back]

     glGet with	argument GL_LIST_INDEX
     glGet with	argument GL_LIST_MODE

SEE ALSO    [Toc]    [Back]

     glCallList, glCallLists, glDeleteLists, glGenLists

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
glcfont IRIX replace fonts in the font list
sd HP-UX display and monitor job information and create and remove jobs; invoke graphical user interface to display and
swjob HP-UX display and monitor job information and create and remove jobs; invoke graphical user interface to display and
lreplace IRIX Replace elements in a list with new elements
curs_pad IRIX create and display curses pads
gllistparametersgix IRIX specify display list parameters
glcalllist IRIX execute a display list
glCallList Tru64 execute a display list
subpad FreeBSD create and display curses pads
curs_pad OpenBSD create and display curses pads
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service