glListParameterSGIX(3G)

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


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


PARAMETERS
     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
     void glListParameterfvSGIX( GLuint list,
                                 GLenum pname,
                                 const GLfloat *params )
     void glListParameterivSGIX( GLuint list,
                                 GLenum pname,
                                 const GLint *params )


PARAMETERS
     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
     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.
     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
     glListParameterSGIX is part of the SGIX_list_priority extension.  See
     glIntro for more information about using extensions.

ERRORS
     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
     glGetListParameterSGIX with argument GL_LIST_PRIORITY_SGIX
     glGetString with argument GL_EXTENSIONS


SEE ALSO
     glGetListParameterSGIX.