1GLGETCONVOLUTIONPARAMETER(3G)                    GLGETCONVOLUTIONPARAMETER(3G)
2
3
4

NAME

6       glGetConvolutionParameterfv, glGetConvolutionParameteriv - get convolu‐
7       tion parameters
8
9

C SPECIFICATION

11       void glGetConvolutionParameterfv( GLenum target,
12                                         GLenum pname,
13                                         GLfloat *params )
14       void glGetConvolutionParameteriv( GLenum target,
15                                         GLenum pname,
16                                         GLint *params )
17
18

PARAMETERS

20       target  The filter whose parameters are to be retrieved.  Must  be  one
21               of GL_CONVOLUTION_1D, GL_CONVOLUTION_2D, or GL_SEPARABLE_2D.
22
23       pname   The    parameter   to   be   retrieved.    Must   be   one   of
24               GL_CONVOLUTION_BORDER_MODE,        GL_CONVOLUTION_BORDER_COLOR,
25               GL_CONVOLUTION_FILTER_SCALE,        GL_CONVOLUTION_FILTER_BIAS,
26               GL_CONVOLUTION_FORMAT,                    GL_CONVOLUTION_WIDTH,
27               GL_CONVOLUTION_HEIGHT,       GL_MAX_CONVOLUTION_WIDTH,       or
28               GL_MAX_CONVOLUTION_HEIGHT.
29
30       params  Pointer to storage for the parameters to be retrieved.
31

DESCRIPTION

33       glGetConvolutionParameter  retrieves  convolution  parameters.   target
34       determines which convolution filter is queried.  pname determines which
35       parameter is returned:
36
37       GL_CONVOLUTION_BORDER_MODE
38              The convolution border mode.  See glConvolutionParameter  for  a
39              list of border modes.
40
41       GL_CONVOLUTION_BORDER_COLOR
42              The  current convolution border color.  params must be a pointer
43              to an array of four elements, which will receive the red, green,
44              blue, and alpha border colors.
45
46       GL_CONVOLUTION_FILTER_SCALE
47              The  current  filter scale factors.  params must be a pointer to
48              an array of four elements, which will receive  the  red,  green,
49              blue, and alpha filter scale factors in that order.
50
51       GL_CONVOLUTION_FILTER_BIAS
52              The current filter bias factors.  params must be a pointer to an
53              array of four elements, which will receive the red, green, blue,
54              and alpha filter bias terms in that order.
55
56       GL_CONVOLUTION_FORMAT
57              The    current    internal    .     See   glConvolutionFilter1D,
58              glConvolutionFilter2D,  and  glSeparableFilter2D  for  lists  of
59              allowable formats.
60
61       GL_CONVOLUTION_WIDTH
62              The current filter image width.
63
64       GL_CONVOLUTION_HEIGHT
65              The current filter image height.
66
67       GL_MAX_CONVOLUTION_WIDTH
68              The maximum acceptable filter image width.
69
70       GL_MAX_CONVOLUTION_HEIGHT
71              The maximum acceptable filter image height.
72

ERRORS

74       GL_INVALID_ENUM is generated if target is not one of the allowable val‐
75       ues.
76
77       GL_INVALID_ENUM is generated if pname is not one of the allowable  val‐
78       ues.
79
80       GL_INVALID_ENUM  is  generated if target is GL_CONVOLUTION_1D and pname
81       is GL_CONVOLUTION_HEIGHT or GL_MAX_CONVOLUTION_HEIGHT.
82
83       GL_INVALID_OPERATION is generated if glGetConvolutionParameter is  exe‐
84       cuted  between the execution of glBegin and the corresponding execution
85       of glEnd.
86

SEE ALSO

88       glGetConvolutionFilter(3G),                 glGetSeparableFilter2D(3G),
89       glConvolutionParameter(3G)
90
91
92
93                                                 GLGETCONVOLUTIONPARAMETER(3G)