glGetConvolutionParameter — get convolution parameters
void glGetConvolutionParameterfv( | GLenum | target, |
| GLenum | pname, | |
| GLfloat * | params); |
void glGetConvolutionParameteriv( | GLenum | target, |
| GLenum | pname, | |
| GLint * | params); |
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.
paramsPointer to storage for the parameters to be retrieved.
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 format. 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.
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
and pname is GL_CONVOLUTION_HEIGHT or
GL_MAX_CONVOLUTION_HEIGHT.
GL_INVALID_OPERATION is generated if glGetConvolutionParameter is executed
between the execution of glBegin and the corresponding
execution of glEnd.
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.