GLCONVOLUTIONPARAMETEREXT(3GL)GLCONVOLUTIONPARAMETEREXT(3GL)NAME
glConvolutionParameteriEXT, glConvolutionParameterfEXT, glConvolution‐
ParameterivEXT, glConvolutionParameterfvEXT - specify convolution
parameters
C SPECIFICATION
void glConvolutionParameteriEXT ( GLenum target,
GLenum pname,
GLint param);
void glConvolutionParameterfEXT ( GLenum target,
GLenum pname,
GLfloat param);
PARAMATERS
target The target Convolution filter. Must be GL_CONVOLUTION_1D_EXT,
GL_CONVOLUTION_2D_EXT or GL_SEPARABLE_2D_EXT.
pname The Symbolic name of border mode. Must be GL_CONVOLUTION_BOR‐
DER_MODE_EXT.
param Specify the border mode. Must be one of GL_REDUCE_EXT,
GL_IGNORE_BORDER_HP, GL_CONSTANT_BORDER_HP, GL_WRAP_BORDER_SUN
or GL_REPLICATE_BORDER_HP.
C SPECIFICATION
void glConvolutionParameterivEXT ( GLenum target,
GLenum pname,
const GLint* params);
void glConvolutionParameterfvEXT ( GLenum target,
GLenum pname,
const GLfloat* params);
PARAMETERS
target The target Convolution filter. Must be GL_CONVOLUTION_1D_EXT,
GL_CONVOLUTION_2D_EXT or GL_SEPARABLE_2D_EXT.
pname The Symbolic names of various convolution parameters. Must be
one of GL_CONVOLUTION_FILTER_SCALE_EXT, GL_CONVOLUTION_FIL‐
TER_BIAS_EXT, GL_CONVOLUTION_BORDER_MODE_EXT or GL_CONVOLU‐
TION_BORDER_COLOR_HP.
params A pointer to an array where the values of the parameters are
stored.
DESCRIPTION
glConvolutionParameter*EXT is part of the GL_EXT_convolution extension,
which adds convolution to the pixel transfer path.
glConvolutionParameteriEXT and glConvolutionParameterfEXT are used to
specify the border mode for a specific convolution filter with the
<target> parameter set to the name of the filter, the <pname> parameter
set to GL_CONVOLUTION_BORDER_MODE_EXT and <param> set to one of
GL_REDUCE_EXT, GL_IGNORE_BORDER_HP, GL_CONSTANT_BORDER_HP, GL_WRAP_BOR‐
DER_SUN or GL_REPLICATE_BORDER_HP.
glConvolutionParameterivEXT and glConvolutionParameterfvEXT are used to
specify Border modes, Scale and Bias values and Border Color. <pname>
must be one of GL_CONVOLUTION_BORDER_MODE_EXT, GL_CONVOLUTION_FIL‐
TER_SCALE_EXT, GL_CONVOLUTION_FILTER_BIAS_EXT or GL_CONVOLUTION_BOR‐
DER_COLOR_HP. For Scale, Bias and Border color, <params> point to an
array of four values which are the scale, bias and border color compo‐
nents for red, green, blue and alpha, in that order. For border mode,
<params> point to an array with a single border mode value. Must be one
of GL_REDUCE_EXT, GL_IGNORE_BORDER_HP, GL_CONSTANT_BORDER_HP,
GL_WRAP_BORDER_SUN or GL_REPLICATE_BORDER_HP.
NOTES
Border modes GL_IGNORE_BORDER_HP, GL_CONSTANT_BORDER_HP, GL_REPLI‐
CATE_BORDER_HP are part of the GL_HP_convolution_border_modes exten‐
sion. GL_WRAP_BORDER_SUN is a Sun specific extension. GL_REDUCE_EXT is
part of GL_EXT_convolution extension.
ERRORS
GL_INVALID_ENUM is generated if target is not one of the acceptable
values.
GL_INVALID_ENUM is generated if pname is not one of the acceptable val‐
ues.
ASSOCIATED GETS
glGetConvolutionParameterivEXT, glGetConvolutionParameterfvEXT.
SEE ALSO
glConvolutionFilter1DEXT, glConvolutionFilter2DEXT, glSeparable‐
Filter2DEXT, glCopyConvolutionFilter1DEXT, glCopyConvolutionFil‐
ter2DEXT, glTexImage1D, glGetTexImage, glDrawPixels, glCopyPixels,
glReadPixels, glTexImage2D, glTexSubImage2DEXT, glCopyTexIm‐
age2DEXT,aglCopyTexSubImage2DEXT, glGetTexImage, glPixelTransferf,
glPixelTransferi.
1 Dec 97 GLCONVOLUTIONPARAMETEREXT(3GL)