fglGetTexFilterFuncSGIS(3G)

NAME
     fglGetTexFilterFuncSGIS - return user-defined texture filtering function


FORTRAN SPECIFICATION
     SUBROUTINE fglGetTexFilterFuncSGIS( INTEGER*4 target,
                                         INTEGER*4 filter,
                                         CHARACTER*8 weights )


PARAMETERS
     target   Specifies the target texture whose filtering function weights
              are to be returned.  Must be GL_TEXTURE_1D or GL_TEXTURE_2D.

     filter   Specifies the filter function whose weights are to be returned.
              Must be GL_FILTER4_SGIS.

     weights  Specifies an array to receive the floating-point weight values.

DESCRIPTION
     fglGetTexFilterFuncSGIS returns in weights the user-defined filtering
     function specified by fglTexFilterFuncSGIS.  weights must have Size
     elements, where Size is determined by calling fglGetTexParameter with
     argument GL_TEXTURE_FILTER4_SIZE_SGIS.

NOTES
     fglGetTexFilterFuncSGIS is part of the SGIS_texture_filter4 extension,
     not part of the core GL command set.  If GL_SGIS_texture_filter4 is
     included in the string returned by fglGetString when called with argument
     GL_EXTENSIONS, extension SGIS_texture_filter4 is supported by the
     connection.  See fglIntro for more information about using extensions.

ERRORS
     GL_INVALID_ENUM is generated if either target or filter is not one of the
     allowable values.

     GL_INVALID_OPERATION is generated if fglGetTexFilterFuncSGIS is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.


MACHINE DEPENDENCIES
     The SGIS_texture_filter4 extension is supported only on InfiniteReality
     systems.

     On InfiniteReality systems, GL_INVALID_VALUE is generated if the value of
     the argument n to the command fglTexFilterFuncSGIS does not equal the
     value of the implementation dependent constant Size, which can be
     determined by calling fglGetTexParameter with argument
     GL_TEXTURE_FILTER4_SIZE_SGIS.  This restriction will be removed in a
     future release.
SEE ALSO
     fglTexFilterFuncSGIS, fglTexParameter.