glGetConvolutionParameter(3) glGetConvolutionParameter(3)
NAME
glGetConvolutionParameterfv, glGetConvolutionParameteriv - get convolu-
tion parameters
C SPECIFICATION
void glGetConvolutionParameterfv( GLenum target,
GLenum pname,
GLfloat *params )
void glGetConvolutionParameteriv( GLenum target,
GLenum pname,
GLint *params )
PARAMETERS
target The filter whose parameters are to be retrieved. Must be one
of GL_CONVOLUTION_1D, GL_CONVOLUTION_2D, or GL_SEPARABLE_2D.
pname The parameter to be retrieved. Must be one of
GL_CONVOLUTION_BORDER_MODE, GL_CONVOLUTION_BORDER_COLOR,
GL_CONVOLUTION_FILTER_SCALE, GL_CONVOLUTION_FILTER_BIAS,
GL_CONVOLUTION_FORMAT, GL_CONVOLUTION_WIDTH,
GL_CONVOLUTION_HEIGHT, GL_MAX_CONVOLUTION_WIDTH, or
GL_MAX_CONVOLUTION_HEIGHT.
params Pointer to storage for the parameters to be retrieved.
DESCRIPTION
glGetConvolutionParameter retrieves convolution parameters. target
determines which convolution filter is queried. pname determines which
parameter is returned:
GL_CONVOLUTION_BORDER_MODE
The convolution border mode. See glConvolutionParameter for a
list of border modes.
GL_CONVOLUTION_BORDER_COLOR
The current convolution border color. params must be a pointer
to an array of four elements, which will receive the red, green,
blue, and alpha border colors.
GL_CONVOLUTION_FILTER_SCALE
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
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
The current internal . See glConvolutionFilter1D,
glConvolutionFilter2D, and glSeparableFilter2D for lists of
allowable formats.
GL_CONVOLUTION_WIDTH
The current filter image width.
GL_CONVOLUTION_HEIGHT
The current filter image height.
GL_MAX_CONVOLUTION_WIDTH
The maximum acceptable filter image width.
GL_MAX_CONVOLUTION_HEIGHT
The maximum acceptable filter image height.
ERRORS
GL_INVALID_ENUM is generated if target is not one of the allowable val-
ues.
GL_INVALID_ENUM is generated if pname is not one of the allowable val-
ues.
GL_INVALID_ENUM is generated if target is GL_CONVOLUTION_1D and pname
is GL_CONVOLUTION_HEIGHT or GL_MAX_CONVOLUTION_HEIGHT.
GL_INVALID_OPERATION is generated if glGetConvolutionParameter is exe-
cuted between the execution of glBegin and the corresponding execution
of glEnd.
SEE ALSO
glGetConvolutionFilter(3), glGetSeparableFilter2D(3),
glConvolutionParameter(3)
glGetConvolutionParameter(3)
Mac OS X 10.6 - Generated Thu Sep 17 20:20:21 CDT 2009