1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
'\" t
'\"! tbl | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 001 getconvo
.ds Xs 10201 5 getconvolutionparameter.gl
.TH GLGETCONVOLUTIONPARAMETER 3G
.SH NAME
.B "glGetConvolutionParameterfv, glGetConvolutionParameteriv
\- get convolution parameters
.SH C SPECIFICATION
void \f3glGetConvolutionParameterfv\fP(
GLenum \fItarget\fP,
.nf
.ta \w'\f3void \fPglGetConvolutionParameterfv( 'u
GLenum \fIpname\fP,
GLfloat \fI*params\fP )
.fi
void \f3glGetConvolutionParameteriv\fP(
GLenum \fItarget\fP,
.nf
.ta \w'\f3void \fPglGetConvolutionParameteriv( 'u
GLenum \fIpname\fP,
GLint \fI*params\fP )
.fi
.SH PARAMETERS
.TP \w'\f2target\fP\ \ 'u
\f2target\fP
The filter whose parameters are to be retrieved.
Must be one of
\%\f3GL_CONVOLUTION_1D\fP,
\%\f3GL_CONVOLUTION_2D\fP, or
\%\f3GL_SEPARABLE_2D\fP.
.TP
\f2pname\fP
The parameter to be retrieved.
Must be one of
\%\f3GL_CONVOLUTION_BORDER_MODE\fP,
\%\f3GL_CONVOLUTION_BORDER_COLOR\fP,
\%\f3GL_CONVOLUTION_FILTER_SCALE\fP,
\%\f3GL_CONVOLUTION_FILTER_BIAS\fP,
\%\f3GL_CONVOLUTION_FORMAT\fP,
\%\f3GL_CONVOLUTION_WIDTH\fP,
\%\f3GL_CONVOLUTION_HEIGHT\fP,
\%\f3GL_MAX_CONVOLUTION_WIDTH\fP, or
\%\f3GL_MAX_CONVOLUTION_HEIGHT\fP.
.TP
\f2params\fP
Pointer to storage for the parameters to be retrieved.
.SH DESCRIPTION
\%\f3glGetConvolutionParameter\fP retrieves convolution parameters.
\f2target\fP determines which convolution filter is queried.
\f2pname\fP determines which parameter is returned:
.TP
\%\f3GL_CONVOLUTION_BORDER_MODE\fP
The convolution border mode.
See \%\f3glConvolutionParameter\fP for a list of border modes.
.TP
\%\f3GL_CONVOLUTION_BORDER_COLOR\fP
The current convolution border color.
\f2params\fP must be a pointer to an array of four elements,
which will receive the red, green, blue, and alpha border colors.
.TP
\%\f3GL_CONVOLUTION_FILTER_SCALE\fP
The current filter scale factors.
\f2params\fP 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.
.TP
\%\f3GL_CONVOLUTION_FILTER_BIAS\fP
The current filter bias factors.
\f2params\fP 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.
.TP
\%\f3GL_CONVOLUTION_FORMAT\fP
The current internal .
See \%\f3glConvolutionFilter1D\fP, \%\f3glConvolutionFilter2D\fP,
and \%\f3glSeparableFilter2D\fP for lists of allowable formats.
.TP
\%\f3GL_CONVOLUTION_WIDTH\fP
The current filter image width.
.TP
\%\f3GL_CONVOLUTION_HEIGHT\fP
The current filter image height.
.TP
\%\f3GL_MAX_CONVOLUTION_WIDTH\fP
The maximum acceptable filter image width.
.TP
\%\f3GL_MAX_CONVOLUTION_HEIGHT\fP
The maximum acceptable filter image height.
.SH ERRORS
\%\f3GL_INVALID_ENUM\fP is generated if \f2target\fP is not one of the allowable
values.
.P
\%\f3GL_INVALID_ENUM\fP is generated if \f2pname\fP is not one of the allowable
values.
.P
\%\f3GL_INVALID_ENUM\fP is generated if \f2target\fP is \%\f3GL_CONVOLUTION_1D\fP
and \f2pname\fP is \%\f3GL_CONVOLUTION_HEIGHT\fP or
\%\f3GL_MAX_CONVOLUTION_HEIGHT\fP.
.P
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGetConvolutionParameter\fP is executed
between the execution of \%\f3glBegin\fP and the corresponding
execution of \%\f3glEnd\fP.
.SH SEE ALSO
\%\f3glGetConvolutionFilter(3G)\fP,
\%\f3glGetSeparableFilter2D(3G)\fP,
\%\f3glConvolutionParameter(3G)\fP
|
