fglListParameterSGIX(3G)

NAME
     fglListParameterfSGIX, fglListParameteriSGIX, fglListParameterfvSGIX,
     fglListParameterivSGIX - specify display list parameters


FORTRAN SPECIFICATION
     SUBROUTINE fglListParameterfSGIX( INTEGER*4 list,
                                       INTEGER*4 pname,
                                       REAL*4 param )
     SUBROUTINE fglListParameteriSGIX( INTEGER*4 list,
                                       INTEGER*4 pname,
                                       INTEGER*4 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].

FORTRAN SPECIFICATION
     SUBROUTINE fglListParameterfvSGIX( INTEGER*4 list,
                                        INTEGER*4 pname,
                                        CHARACTER*8 params )
     SUBROUTINE fglListParameterivSGIX( INTEGER*4 list,
                                        INTEGER*4 pname,
                                        CHARACTER*8 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
     fglListParameterSGIX 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 fglListParameteriSGIX or fglListParameterivSGIX 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.

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

     fglListParameterSGIX is not included in display lists.

NOTES
     fglListParameterSGIX is part of the SGIX_list_priority extension.  See
     fglIntro 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 fglListParameterSGIX is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.

ASSOCIATED GETS
     fglGetListParameterSGIX with argument GL_LIST_PRIORITY_SGIX
     fglGetString with argument GL_EXTENSIONS


SEE ALSO
     fglGetListParameterSGIX.