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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
'\" te
'\"! tbl|eqn | 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 01 getmap.gl
.ds Xs 19970 5 getmap.gl
.TH GLGETMAP 3G
.SH NAME
.B "glGetMapdv, glGetMapfv, glGetMapiv
\- return evaluator parameters
.SH C SPECIFICATION
void \f3glGetMapdv\fP(
GLenum \fItarget\fP,
.nf
.ta \w'\f3void \fPglGetMapdv( 'u
GLenum \fIquery\fP,
GLdouble \fI*v\fP )
.fi
void \f3glGetMapfv\fP(
GLenum \fItarget\fP,
.nf
.ta \w'\f3void \fPglGetMapfv( 'u
GLenum \fIquery\fP,
GLfloat \fI*v\fP )
.fi
void \f3glGetMapiv\fP(
GLenum \fItarget\fP,
.nf
.ta \w'\f3void \fPglGetMapiv( 'u
GLenum \fIquery\fP,
GLint \fI*v\fP )
.fi
.EQ
delim $$
.EN
.SH PARAMETERS
.TP \w'\f2target\fP\ \ 'u
\f2target\fP
Specifies the symbolic name of a map.
Accepted values are
\%\f3GL_MAP1_COLOR_4\fP,
\%\f3GL_MAP1_INDEX\fP,
\%\f3GL_MAP1_NORMAL\fP,
\%\f3GL_MAP1_TEXTURE_COORD_1\fP,
\%\f3GL_MAP1_TEXTURE_COORD_2\fP,
\%\f3GL_MAP1_TEXTURE_COORD_3\fP,
\%\f3GL_MAP1_TEXTURE_COORD_4\fP,
\%\f3GL_MAP1_VERTEX_3\fP,
\%\f3GL_MAP1_VERTEX_4\fP,
\%\f3GL_MAP2_COLOR_4\fP,
\%\f3GL_MAP2_INDEX\fP,
\%\f3GL_MAP2_NORMAL\fP,
\%\f3GL_MAP2_TEXTURE_COORD_1\fP,
\%\f3GL_MAP2_TEXTURE_COORD_2\fP,
\%\f3GL_MAP2_TEXTURE_COORD_3\fP,
\%\f3GL_MAP2_TEXTURE_COORD_4\fP,
\%\f3GL_MAP2_VERTEX_3\fP, and
\%\f3GL_MAP2_VERTEX_4\fP.
.TP
\f2query\fP
Specifies which parameter to return.
Symbolic names
\%\f3GL_COEFF\fP,
\%\f3GL_ORDER\fP, and
\%\f3GL_DOMAIN\fP are accepted.
.TP
\f2v\fP
Returns the requested data.
.SH DESCRIPTION
\%\f3glMap1\fP and \%\f3glMap2\fP define evaluators.
\%\f3glGetMap\fP returns evaluator parameters.
\f2target\fP chooses a map,
\f2query\fP selects a specific parameter,
and \f2v\fP points to storage where the values will be returned.
.P
The acceptable values for the \f2target\fP parameter are described
in the \%\f3glMap1\fP and \%\f3glMap2\fP reference pages.
.P
\f2query\fP can assume the following values:
.TP 15
\%\f3GL_COEFF\fP
\f2v\fP returns the control points for the evaluator function.
One-dimensional evaluators return $order$ control points,
and two-dimensional evaluators return $uorder ~times~ vorder$ control points.
Each control point consists of one, two, three, or four integer,
single-precision floating-point,
or double-precision floating-point values,
depending on the type of the evaluator.
The GL returns two-dimensional control points in row-major order,
incrementing the $uorder$ index quickly
and the $vorder$ index after each row.
Integer values,
when requested,
are computed by rounding the internal floating-point values to the
nearest integer values.
.TP
\%\f3GL_ORDER\fP
\f2v\fP returns the order of the evaluator function.
One-dimensional evaluators return a single value,
$order$. The initial value is 1.
Two-dimensional evaluators return two values,
$uorder$ and $vorder$. The initial value is 1,1.
.TP
\%\f3GL_DOMAIN\fP
\f2v\fP returns the linear $u$ and $v$ mapping parameters.
One-dimensional evaluators return two values,
$u1$ and $u2$,
as specified by \%\f3glMap1\fP.
Two-dimensional evaluators return four values
($u1$, $u2$, $v1$, and $v2$)
as specified by \%\f3glMap2\fP.
Integer values,
when requested,
are computed by rounding the internal floating-point values to the
nearest integer values.
.SH NOTES
If an error is generated,
no change is made to the contents of \f2v\fP.
.SH ERRORS
\%\f3GL_INVALID_ENUM\fP is generated if either \f2target\fP or \f2query\fP is not
an accepted value.
.P
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGetMap\fP
is executed between the execution of \%\f3glBegin\fP
and the corresponding execution of \%\f3glEnd\fP.
.SH SEE ALSO
\%\f3glEvalCoord(3G)\fP,
\%\f3glMap1(3G)\fP,
\%\f3glMap2(3G)\fP
|
