1991-2006 Silicon Graphics, Inc.
glGetConvolutionParameter 3G
glGetConvolutionParameter get convolution 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 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.

## 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` 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.

## See Also

glGetConvolutionFilter, glGetSeparableFilter, glConvolutionParameter

## Copyright

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/.