glListParameterSGIX(3G)	       OpenGL Reference	       glListParameterSGIX(3G)

NAME    [Toc]    [Back]

     glListParameterfSGIX, glListParameteriSGIX, glListParameterfvSGIX,
     glListParameterivSGIX - specify display list parameters

C SPECIFICATION    [Toc]    [Back]

     void glListParameterfSGIX(	GLuint list,
				GLenum pname,
				GLfloat	param )
     void glListParameteriSGIX(	GLuint list,
				GLenum pname,
				GLint param )

PARAMETERS    [Toc]    [Back]

     list    Specifies the integer name	of the display list whose parameters
	     are to be set.

     pname   Specifies the symbolic name for a display list parameter. Must be
	     GL_LIST_PRIORITY_SGIX.

     param   Specifies a single	value for the selected display list parameter.
	     If	pname is GL_LIST_PRIORITY_SGIX,	then the value must be a
	     display list priority in the range	[0.0, 1.0].

C SPECIFICATION    [Toc]    [Back]

     void glListParameterfvSGIX( GLuint	list,
				 GLenum	pname,
				 const GLfloat *params )
     void glListParameterivSGIX( GLuint	list,
				 GLenum	pname,
				 const GLint *params )

PARAMETERS    [Toc]    [Back]

     list Specifies the	integer	name of	the display list whose parameters are
	  to be	set.

     pname
	  Specifies the	symbolic name for a display list parameter. Must be
	  GL_LIST_PRIORITY_SGIX.

     params
	  Specifies a pointer to an array containing the parameter value. If
	  pname	is GL_LIST_PRIORITY_SGIX, then the array must contain a	single
	  element specifying the list priority.

DESCRIPTION    [Toc]    [Back]

     glListParameterSGIX specifies values for display list parameters. pname
     must be GL_LIST_PRIORITY_SGIX, in which case the display list priority is
     specified in params.




									Page 1






glListParameterSGIX(3G)	       OpenGL Reference	       glListParameterSGIX(3G)



     The display list priority guides the OpenGL implementation	in determining
     which display lists should	be favoured for	fast execution (by placing
     them in special high-performance display list memory, for example).

     The priority specified in params is clamped to the	range [0.0, 1.0]
     before assignment.	Zero indicates the lowest priority, and	hence the
     least likelihood of optimal execution. One	indicates the highest
     priority, and hence the greatest likelihood of optimal execution. The
     default priority value for	every list is one.

     If	glListParameteriSGIX or	glListParameterivSGIX are used to specify list
     priority, the integer value is clamped to the range [0.0, 1.0]; it	is not
     converted to a floating-point value as, for example, colors are
     converted.

     glListParameterSGIX silently ignores attempts to prioritize integer names
     that do not refer to lists, or lists which	have not yet been completely
     defined.

     glListParameterSGIX is not	included in display lists.

NOTES    [Toc]    [Back]

     glListParameterSGIX is part of the	SGIX_list_priority extension.  See
     glIntro for more information about	using extensions.

ERRORS    [Toc]    [Back]

     GL_INVALID_VALUE is generated if the parameter list is 0.

     GL_INVALID_ENUM is	generated if the parameter pname is not	one of the
     accepted values.

     GL_INVALID_OPERATION is generated if glListParameterSGIX is executed
     between the execution of glBegin and the corresponding execution of
     glEnd.

ASSOCIATED GETS    [Toc]    [Back]

     glGetListParameterSGIX with argument GL_LIST_PRIORITY_SGIX
     glGetString with argument GL_EXTENSIONS

SEE ALSO    [Toc]    [Back]

     glGetListParameterSGIX.


									PPPPaaaaggggeeee 2222