---
name: "glGetConvolutionParameter"
section: "3x"
platform: "linux"
package: "xlibmesa-gl-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/glGetConvolutionParameter"
---

# glGetConvolutionParameter(3x)

get convolution parameters

## NAME

**glGetConvolutionParameterfv, glGetConvolutionParameteriv** - 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 . 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(3G)**, **glGetSeparableFilter2D(3G)**, **glConvolutionParameter(3G)**