fglListParameterSGIX(3G) OpenGL Reference 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.
Page 1
fglListParameterSGIX(3G) OpenGL Reference fglListParameterSGIX(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 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.
Page 2