gllistparameterfsgix(3G)



glListParameterSGIX(3G)        OpenGL Reference        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
             GLLISTPRIORITYSGIX.

     param   Specifies a single value for the selected display list parameter.
             If pname is GLLISTPRIORITYSGIX, 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
          GLLISTPRIORITYSGIX.

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

DESCRIPTION
     glListParameterSGIX specifies values for display list parameters. pname
     must be GLLISTPRIORITYSGIX, 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
     glListParameterSGIX is part of the SGIXlistpriority extension.  See
     glIntro for more information about using extensions.

ERRORS
     GLINVALIDVALUE is generated if the parameter list is 0.

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

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

ASSOCIATED GETS
     glGetListParameterSGIX with argument GLLISTPRIORITYSGIX
     glGetString with argument GLEXTENSIONS


SEE ALSO
     glGetListParameterSGIX.













                                                                        Page 2

Museum