fglGetConvolutionParameterEXT(3G) OpenGL Reference
NAME
fglGetConvolutionParameterfvEXT, fglGetConvolutionParameterivEXT - get
convolution parameters
FORTRAN SPECIFICATION
SUBROUTINE fglGetConvolutionParameterfvEXT( INTEGER*4 target,
INTEGER*4 pname,
CHARACTER*8 params )
SUBROUTINE fglGetConvolutionParameterivEXT( INTEGER*4 target,
INTEGER*4 pname,
CHARACTER*8 params )
PARAMETERS
target The filter whose parameters are to be retrieved. Must be one of
GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, or
GL_SEPARABLE_2D_EXT.
pname The parameter to be retrieved. Must be one of
GL_CONVOLUTION_BORDER_MODE_EXT, GL_CONVOLUTION_FILTER_SCALE_EXT,
GL_CONVOLUTION_FILTER_BIAS_EXT, GL_CONVOLUTION_FORMAT_EXT,
GL_CONVOLUTION_WIDTH_EXT, GL_CONVOLUTION_HEIGHT_EXT,
GL_MAX_CONVOLUTION_WIDTH_EXT, or GL_MAX_CONVOLUTION_HEIGHT_EXT.
params Pointer to storage for the parameters to be retrieved.
DESCRIPTION
fglGetConvolutionParameterEXT retrieves convolution parameters. target
determines which convolution filter is queried. pname determines which
parameter is returned:
GL_CONVOLUTION_BORDER_MODE_EXT
The convolution border mode. See fglConvolutionParameterEXT for a
list of border modes.
GL_CONVOLUTION_FILTER_SCALE_EXT
The current filter scale factors. params must be a pointer to an
array of four elements, which will receive the red, green, blue, and
alpha filter scale factors in that order.
GL_CONVOLUTION_FILTER_BIAS_EXT
The current filter bias factors. params must be a pointer to an
array of four elements, which will receive the red, green, blue, and
alpha filter bias terms in that order.
GL_CONVOLUTION_FORMAT_EXT
The current internal format. See fglConvolutionFilter1DEXT,
fglConvolutionFilter2DEXT, and fglSeparableFilter2DEXT for lists of
allowable formats.
Page 1
fglGetConvolutionParameterEXT(3G) OpenGL Reference
GL_CONVOLUTION_WIDTH_EXT
The current filter image width.
GL_CONVOLUTION_HEIGHT_EXT
The current filter image height.
GL_MAX_CONVOLUTION_WIDTH_EXT
The maximum acceptable filter image width.
GL_MAX_CONVOLUTION_HEIGHT_EXT
The maximum acceptable filter image height.
ERRORS
GL_INVALID_ENUM is generated if target is not one of the allowable
values.
GL_INVALID_ENUM is generated if pname is not one of the allowable values.
GL_INVALID_ENUM is generated if target is GL_CONVOLUTION_1D_EXT and pname
is GL_CONVOLUTION_HEIGHT_EXT or GL_MAX_CONVOLUTION_HEIGHT_EXT.
GL_INVALID_OPERATION is generated if fglGetConvolutionParameterEXT is
executed between the execution of fglBegin and the corresponding
execution of fglEnd.
MACHINE DEPENDENCIES
RealityEngine, RealityEngine2, and VTX systems cannot retrieve
GL_MAX_CONVOLUTION_WIDTH_EXT or GL_MAX_CONVOLUTION_HEIGHT_EXT.
SEE ALSO
fglGetConvolutionFilterEXT, fglGetSeparableFilter2DEXT,
fglConvolutionParameterEXT.
Page 2
