📄 newlist.html

📁 glman函数说明 glman函数说明 glman函数说明
💻 HTML
字号:
<HTML>
<BODY>
<PRE>
     <STRONG>NAME</STRONG>
	  <STRONG>glNewList,</STRONG> <STRONG>glEndList</STRONG> - create	or replace a display list


     <STRONG>C</STRONG> <STRONG>SPECIFICATION</STRONG>
	  void <STRONG>glNewList</STRONG>( GLuint <EM>list</EM>,
			  GLenum <EM>mode</EM> )


     <STRONG>PARAMETERS</STRONG>
	  <EM>list</EM>	Specifies the display-list name.

	  <EM>mode</EM>	Specifies the compilation mode,	which can be
		<STRONG>GL_COMPILE</STRONG> or <STRONG>GL_COMPILE_AND_EXECUTE</STRONG>.

     <STRONG>C</STRONG> <STRONG>SPECIFICATION</STRONG>
	  void <STRONG>glEndList</STRONG>( void )


     <STRONG>DESCRIPTION</STRONG>
	  Display lists	are groups of GL commands that have been
	  stored for subsequent	execution.  Display lists are created
	  with <STRONG>glNewList</STRONG>.  All subsequent commands are placed in the
	  display list,	in the order issued, until <STRONG>glEndList</STRONG> is
	  called.

	  <STRONG>glNewList</STRONG> has	two arguments.	The first argument, <EM>list</EM>, is a
	  positive integer that	becomes	the unique name	for the
	  display list.	 Names can be created and reserved with
	  <STRONG>glGenLists</STRONG> and tested	for uniqueness with <STRONG>glIsList</STRONG>.  The
	  second argument, <EM>mode</EM>, is a symbolic constant	that can
	  assume one of	two values:

	  <STRONG>GL_COMPILE</STRONG>			Commands are merely compiled.

	  <STRONG>GL_COMPILE_AND_EXECUTE</STRONG>	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 <STRONG>glColorPointer</STRONG>, <STRONG>glDeleteLists</STRONG>,
	  <STRONG>glDisableClientState</STRONG>,	<STRONG>glEdgeFlagPointer</STRONG>,
	  <STRONG>glEnableClientState</STRONG>, <STRONG>glFeedbackBuffer</STRONG>, <STRONG>glFinish</STRONG>, <STRONG>glFlush</STRONG>,
	  <STRONG>glGenLists</STRONG>, <STRONG>glIndexPointer</STRONG>, <STRONG>glInterleavedArrays</STRONG>,
	  <STRONG>glIsEnabled</STRONG>, <STRONG>glIsList</STRONG>, <STRONG>glNormalPointer</STRONG>, <STRONG>glPopClientAttrib</STRONG>,
	  <STRONG>glPixelStore</STRONG>,	<STRONG>glPushClientAttrib</STRONG>, <STRONG>glReadPixels</STRONG>,
	  <STRONG>glRenderMode</STRONG>,	<STRONG>glSelectBuffer</STRONG>,	<STRONG>glTexCoordPointer</STRONG>,
	  <STRONG>glVertexPointer</STRONG>, and all of the <STRONG>glGet</STRONG>	commands.

	  Similarly, <STRONG>glTexImage2D</STRONG> and <STRONG>glTexImage1D</STRONG> are executed
	  immediately and not compiled into the	display	list when
	  their	first argument is <STRONG>GL_PROXY_TEXTURE_2D</STRONG> or
	  <STRONG>GL_PROXY_TEXTURE_1D</STRONG>, respectively.

	  When <STRONG>glEndList</STRONG> is encountered, the display-list definition
	  is completed by associating the list with the	unique name
	  <EM>list</EM> (specified in the <STRONG>glNewList</STRONG> command). If	a display list
	  with name <EM>list</EM> already exists, it is replaced	only when
	  <STRONG>glEndList</STRONG> is called.

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

	  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 <STRONG>GL_COMPILE</STRONG>	mode, errors are not generated until the list
	  is executed.

     <STRONG>ERRORS</STRONG>
	  <STRONG>GL_INVALID_VALUE</STRONG> is generated	if <EM>list</EM>	is 0.

	  <STRONG>GL_INVALID_ENUM</STRONG> is generated if <EM>mode</EM> is not an accepted
	  value.

	  <STRONG>GL_INVALID_OPERATION</STRONG> is generated if <STRONG>glEndList</STRONG> is called
	  without a preceding <STRONG>glNewList</STRONG>, or if <STRONG>glNewList</STRONG> is called
	  while	a display list is being	defined.

	  <STRONG>GL_INVALID_OPERATION</STRONG> is generated if <STRONG>glNewList</STRONG> or <STRONG>glEndList</STRONG>
	  is executed between the execution of <STRONG>glBegin</STRONG> and the
	  corresponding	execution of <STRONG>glEnd</STRONG>.

	  <STRONG>GL_OUT_OF_MEMORY</STRONG> 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.)

     <STRONG>ASSOCIATED</STRONG>	<STRONG>GETS</STRONG>
	  <STRONG>glIsList</STRONG>
	  <STRONG>glGet</STRONG>	with argument <STRONG>GL_LIST_INDEX</STRONG>
	  <STRONG>glGet</STRONG>	with argument <STRONG>GL_LIST_MODE</STRONG>

     <STRONG>SEE</STRONG> <STRONG>ALSO</STRONG>
	  <STRONG>glCallList</STRONG>, <STRONG>glCallLists</STRONG>, <STRONG>glDeleteLists</STRONG>, <STRONG>glGenLists</STRONG>


</PRE>
</BODY>
</HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -