1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
2 <!-- saved from url=(0013)about:internet -->
3 <?xml-stylesheet type=
"text/xsl" href=
"mathml.xsl"?><html xmlns=
"http://www.w3.org/1999/xhtml" xmlns:
pref=
"http://www.w3.org/2002/Math/preference" pref:
renderer=
"mathplayer-dl"><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" /><title>glMap1
</title><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.73.2" /></head><body><div class=
"refentry" lang=
"en" xml:
lang=
"en"><a id=
"glMap1"></a><div class=
"titlepage"></div><div class=
"refnamediv"><h2>Name
</h2><p>glMap1 — define a one-dimensional evaluator
</p></div><div class=
"refsynopsisdiv"><h2>C Specification
</h2><div class=
"funcsynopsis"><table border=
"0" summary=
"Function synopsis" cellspacing=
"0" cellpadding=
"0"><tr><td><code class=
"funcdef">void
<b class=
"fsfunc">glMap1f
</b>(
</code></td><td>GLenum
</td><td><var class=
"pdparam">target
</var>,
</td></tr><tr><td> </td><td>GLfloat
</td><td><var class=
"pdparam">u1
</var>,
</td></tr><tr><td> </td><td>GLfloat
</td><td><var class=
"pdparam">u2
</var>,
</td></tr><tr><td> </td><td>GLint
</td><td><var class=
"pdparam">stride
</var>,
</td></tr><tr><td> </td><td>GLint
</td><td><var class=
"pdparam">order
</var>,
</td></tr><tr><td> </td><td>const GLfloat *
</td><td><var class=
"pdparam">points
</var><code>)
</code>;
</td></tr></table></div><div class=
"funcsynopsis"><table border=
"0" summary=
"Function synopsis" cellspacing=
"0" cellpadding=
"0"><tr><td><code class=
"funcdef">void
<b class=
"fsfunc">glMap1d
</b>(
</code></td><td>GLenum
</td><td><var class=
"pdparam">target
</var>,
</td></tr><tr><td> </td><td>GLdouble
</td><td><var class=
"pdparam">u1
</var>,
</td></tr><tr><td> </td><td>GLdouble
</td><td><var class=
"pdparam">u2
</var>,
</td></tr><tr><td> </td><td>GLint
</td><td><var class=
"pdparam">stride
</var>,
</td></tr><tr><td> </td><td>GLint
</td><td><var class=
"pdparam">order
</var>,
</td></tr><tr><td> </td><td>const GLdouble *
</td><td><var class=
"pdparam">points
</var><code>)
</code>;
</td></tr></table></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"parameters"></a><h2>Parameters
</h2><div class=
"variablelist"><dl><dt><span class=
"term"><em class=
"parameter"><code>target
</code></em></span></dt><dd><p>
4 Specifies the kind of values that are generated by the evaluator.
6 <code class=
"constant">GL_MAP1_VERTEX_3
</code>,
7 <code class=
"constant">GL_MAP1_VERTEX_4
</code>,
8 <code class=
"constant">GL_MAP1_INDEX
</code>,
9 <code class=
"constant">GL_MAP1_COLOR_4
</code>,
10 <code class=
"constant">GL_MAP1_NORMAL
</code>,
11 <code class=
"constant">GL_MAP1_TEXTURE_COORD_1
</code>,
12 <code class=
"constant">GL_MAP1_TEXTURE_COORD_2
</code>,
13 <code class=
"constant">GL_MAP1_TEXTURE_COORD_3
</code>, and
14 <code class=
"constant">GL_MAP1_TEXTURE_COORD_4
</code> are accepted.
15 </p></dd><dt><span class=
"term"><em class=
"parameter"><code>u1
</code></em>,
</span><span class=
"term"><em class=
"parameter"><code>u2
</code></em></span></dt><dd><p>
16 Specify a linear mapping of
17 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">u
</mml:mi></mml:math>,
18 as presented to
<a class=
"citerefentry" href=
"glEvalCoord1.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalCoord1
</span></span></a>,
20 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
22 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
24 the variable that is evaluated by the equations specified by this command.
25 </p></dd><dt><span class=
"term"><em class=
"parameter"><code>stride
</code></em></span></dt><dd><p>
26 Specifies the number of floats or doubles between
27 the beginning of one control point and the beginning of the next one
28 in the data structure referenced in
<em class=
"parameter"><code>points
</code></em>.
29 This allows control points to be embedded in arbitrary data structures.
30 The only constraint is that the values for a particular control point
31 must occupy contiguous memory locations.
32 </p></dd><dt><span class=
"term"><em class=
"parameter"><code>order
</code></em></span></dt><dd><p>
33 Specifies the number of control points.
35 </p></dd><dt><span class=
"term"><em class=
"parameter"><code>points
</code></em></span></dt><dd><p>
36 Specifies a pointer to the array of control points.
37 </p></dd></dl></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"description"></a><h2>Description
</h2><p>
38 Evaluators provide a way to use polynomial or rational polynomial mapping
43 The values produced by an evaluator are sent to further stages
44 of GL processing just as if they had been presented using
45 <a class=
"citerefentry" href=
"glVertex.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glVertex
</span></span></a>,
46 <a class=
"citerefentry" href=
"glNormal.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glNormal
</span></span></a>,
47 <a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a>, and
48 <a class=
"citerefentry" href=
"glColor.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glColor
</span></span></a> commands,
49 except that the generated values do not update the current normal,
53 All polynomial or rational polynomial splines of any degree
54 (up to the maximum degree supported by the GL implementation)
55 can be described using evaluators.
56 These include almost all splines used in computer graphics: B-splines,
57 Bezier curves, Hermite splines, and so on.
59 Evaluators define curves based on Bernstein polynomials.
61 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
64 <mml:mi mathvariant=
"italic">p
</mml:mi>
66 <mml:mfenced open=
"(" close=
")">
67 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
73 </p><div class=
"informalequation"><mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
77 <mml:mi mathvariant=
"italic">p
</mml:mi>
79 <mml:mfenced open=
"(" close=
")">
80 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
88 <mml:mi mathvariant=
"italic">i
</mml:mi>
92 <mml:mi mathvariant=
"italic">n
</mml:mi>
96 <mml:msup><mml:mfenced open=
"" close=
"">
97 <mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
98 <mml:mi mathvariant=
"italic">i
</mml:mi>
101 <mml:mi mathvariant=
"italic">n
</mml:mi>
104 <mml:mfenced open=
"(" close=
")">
105 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
109 <mml:msub><mml:mi mathvariant=
"italic">R
</mml:mi>
110 <mml:mi mathvariant=
"italic">i
</mml:mi>
119 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
121 <mml:msub><mml:mi mathvariant=
"italic">R
</mml:mi>
122 <mml:mi mathvariant=
"italic">i
</mml:mi>
125 is a control point and
126 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
129 <mml:msup><mml:mfenced open=
"" close=
"">
130 <mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
131 <mml:mi mathvariant=
"italic">i
</mml:mi>
134 <mml:mi mathvariant=
"italic">n
</mml:mi>
137 <mml:mfenced open=
"(" close=
")">
138 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
143 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">i
</mml:mi></mml:math>th
144 Bernstein polynomial of degree
145 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">n
</mml:mi></mml:math>
146 (
<em class=
"parameter"><code>order
</code></em> =
147 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
150 <mml:mi mathvariant=
"italic">n
</mml:mi>
156 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
160 <mml:msup><mml:mfenced open=
"" close=
"">
161 <mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
162 <mml:mi mathvariant=
"italic">i
</mml:mi>
165 <mml:mi mathvariant=
"italic">n
</mml:mi>
168 <mml:mfenced open=
"(" close=
")">
169 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
174 <mml:mfenced open=
"(" close=
")">
175 <mml:mfenced open=
"" close=
"">
178 <mml:mi mathvariant=
"italic">n
</mml:mi>
181 <mml:mi mathvariant=
"italic">i
</mml:mi>
187 <mml:msup><mml:mfenced open=
"" close=
"">
188 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
190 <mml:mi mathvariant=
"italic">i
</mml:mi>
193 <mml:mfenced open=
"" close=
"">
194 <mml:msup><mml:mfenced open=
"(" close=
")">
198 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
201 <mml:mfenced open=
"" close=
"">
203 <mml:mi mathvariant=
"italic">n
</mml:mi>
205 <mml:mi mathvariant=
"italic">i
</mml:mi>
216 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
219 <mml:msup><mml:mn>0</mml:mn>
227 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
230 <mml:mfenced open=
"(" close=
")">
231 <mml:mfenced open=
"" close=
"">
234 <mml:mi mathvariant=
"italic">n
</mml:mi>
247 <code class=
"function">glMap1
</code> is used to define the basis and to specify what kind of values
250 a map can be enabled and disabled by calling
<a class=
"citerefentry" href=
"glEnable.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEnable
</span></span></a> and
<a class=
"citerefentry" href=
"glDisable.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glDisable
</span></span></a>
251 with the map name, one of the nine predefined values for
<em class=
"parameter"><code>target
</code></em>
253 <a class=
"citerefentry" href=
"glEvalCoord1.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalCoord1
</span></span></a> evaluates the one-dimensional maps that are enabled.
255 <a class=
"citerefentry" href=
"glEvalCoord1.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalCoord1
</span></span></a> presents a value
256 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">u
</mml:mi></mml:math>,
257 the Bernstein functions are evaluated using
258 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
260 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
263 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll">
266 <mml:mover><mml:mi mathvariant=
"italic">u
</mml:mi><mml:mo>̂
</mml:mo></mml:mover>
269 <mml:mfenced open=
"" close=
"">
271 <mml:mi mathvariant=
"italic">u
</mml:mi>
273 <mml:mi mathvariant=
"italic">u1
</mml:mi>
276 <mml:mfenced open=
"" close=
"">
278 <mml:mi mathvariant=
"italic">u2
</mml:mi>
280 <mml:mi mathvariant=
"italic">u1
</mml:mi>
287 <em class=
"parameter"><code>target
</code></em> is a symbolic constant that indicates what kind of control points
288 are provided in
<em class=
"parameter"><code>points
</code></em>,
289 and what output is generated when the map is evaluated.
290 It can assume one of nine predefined values:
291 </p><div class=
"variablelist"><dl><dt><span class=
"term"><code class=
"constant">GL_MAP1_VERTEX_3
</code></span></dt><dd><p>
292 Each control point is three floating-point values representing
293 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math>,
294 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math>,
296 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math>.
297 Internal
<a class=
"citerefentry" href=
"glVertex3.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glVertex3
</span></span></a> commands are generated when the map is evaluated.
298 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_VERTEX_4
</code></span></dt><dd><p>
299 Each control point is four floating-point values representing
300 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math>,
301 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math>,
302 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math>,
304 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">w
</mml:mi></mml:math>.
305 Internal
<a class=
"citerefentry" href=
"glVertex4.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glVertex4
</span></span></a> commands are generated when the map is evaluated.
306 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_INDEX
</code></span></dt><dd><p>
307 Each control point is a single floating-point value representing a color index.
308 Internal
<a class=
"citerefentry" href=
"glIndex.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIndex
</span></span></a> commands are generated when the map is evaluated
309 but the current index is not updated with the value of these
<a class=
"citerefentry" href=
"glIndex.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIndex
</span></span></a>
311 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_COLOR_4
</code></span></dt><dd><p>
312 Each control point is four floating-point values representing
313 red, green, blue, and alpha.
314 Internal
<a class=
"citerefentry" href=
"glColor4.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glColor4
</span></span></a> commands are generated when the map is
315 evaluated but the current color is not updated with the value of these
316 <a class=
"citerefentry" href=
"glColor4.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glColor4
</span></span></a> commands.
317 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_NORMAL
</code></span></dt><dd><p>
318 Each control point is three floating-point values representing
320 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math>,
321 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math>,
323 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math>
324 components of a normal vector.
325 Internal
<a class=
"citerefentry" href=
"glNormal.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glNormal
</span></span></a> commands are generated when the map is
326 evaluated but the current normal is not updated with the value of
327 these
<a class=
"citerefentry" href=
"glNormal.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glNormal
</span></span></a> commands.
328 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_TEXTURE_COORD_1
</code></span></dt><dd><p>
329 Each control point is a single floating-point value representing
331 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">s
</mml:mi></mml:math>
334 <a class=
"citerefentry" href=
"glTexCoord1.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord1
</span></span></a> commands are generated when the map is
335 evaluated but the current texture coordinates are not updated with the value
336 of these
<a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a> commands.
337 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_TEXTURE_COORD_2
</code></span></dt><dd><p>
338 Each control point is two floating-point values representing
340 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">s
</mml:mi></mml:math>
342 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">t
</mml:mi></mml:math>
345 <a class=
"citerefentry" href=
"glTexCoord2.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord2
</span></span></a> commands are generated when the map is
346 evaluated but the current texture coordinates are not updated with the value
347 of these
<a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a> commands.
348 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_TEXTURE_COORD_3
</code></span></dt><dd><p>
349 Each control point is three floating-point values representing
351 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">s
</mml:mi></mml:math>,
352 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">t
</mml:mi></mml:math>,
354 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">r
</mml:mi></mml:math>
356 Internal
<a class=
"citerefentry" href=
"glTexCoord3.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord3
</span></span></a> commands are generated when the map is
357 evaluated but the current texture coordinates are not updated with the value
358 of these
<a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a> commands.
359 </p></dd><dt><span class=
"term"><code class=
"constant">GL_MAP1_TEXTURE_COORD_4
</code></span></dt><dd><p>
360 Each control point is four floating-point values representing
362 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">s
</mml:mi></mml:math>,
363 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">t
</mml:mi></mml:math>,
364 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">r
</mml:mi></mml:math>,
366 <mml:math xmlns:
mml=
"http://www.w3.org/1998/Math/MathML" overflow=
"scroll"><mml:mi mathvariant=
"italic">q
</mml:mi></mml:math>
369 <a class=
"citerefentry" href=
"glTexCoord4.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord4
</span></span></a> commands are generated when the map is evaluated but
370 the current texture coordinates are not updated with the value
371 of these
<a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a> commands.
372 </p></dd></dl></div><p>
373 <em class=
"parameter"><code>stride
</code></em>,
374 <em class=
"parameter"><code>order
</code></em>, and
375 <em class=
"parameter"><code>points
</code></em> define the array addressing for accessing the control points.
376 <em class=
"parameter"><code>points
</code></em> is the location of the first control point,
377 which occupies one, two, three, or four contiguous memory locations,
378 depending on which map is being defined.
379 <em class=
"parameter"><code>order
</code></em> is the number of control points in the array.
380 <em class=
"parameter"><code>stride
</code></em> specifies how many float or double locations to advance the internal
381 memory pointer to reach the next control point.
382 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"notes"></a><h2>Notes
</h2><p>
383 As is the case with all GL commands that accept pointers to data,
384 it is as if the contents of
<em class=
"parameter"><code>points
</code></em> were copied by
<code class=
"function">glMap1
</code> before
<code class=
"function">glMap1
</code>
386 Changes to the contents of
<em class=
"parameter"><code>points
</code></em> have no effect after
<code class=
"function">glMap1
</code> is called.
387 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"errors"></a><h2>Errors
</h2><p>
388 <code class=
"constant">GL_INVALID_ENUM
</code> is generated if
<em class=
"parameter"><code>target
</code></em> is not an accepted value.
390 <code class=
"constant">GL_INVALID_VALUE
</code> is generated if
<em class=
"parameter"><code>u1
</code></em> is equal to
<em class=
"parameter"><code>u2
</code></em>.
392 <code class=
"constant">GL_INVALID_VALUE
</code> is generated if
<em class=
"parameter"><code>stride
</code></em> is less than the number
393 of values in a control point.
395 <code class=
"constant">GL_INVALID_VALUE
</code> is generated if
<em class=
"parameter"><code>order
</code></em> is less than
1 or
396 greater than the return value of
<code class=
"constant">GL_MAX_EVAL_ORDER
</code>.
398 <code class=
"constant">GL_INVALID_OPERATION
</code> is generated if
<code class=
"function">glMap1
</code>
399 is executed between the execution of
400 <a class=
"citerefentry" href=
"glBegin.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glBegin
</span></span></a>
401 and the corresponding execution of
<a class=
"citerefentry" href=
"glEnd.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEnd
</span></span></a>.
403 <code class=
"constant">GL_INVALID_OPERATION
</code> is generated if
<code class=
"function">glMap1
</code> is called and the value
404 of
<code class=
"constant">GL_ACTIVE_TEXTURE
</code> is not
<code class=
"constant">GL_TEXTURE0
</code>.
405 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"associatedgets"></a><h2>Associated Gets
</h2><p>
406 <a class=
"citerefentry" href=
"glGetMap.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glGetMap
</span></span></a>
408 <a class=
"citerefentry" href=
"glGet.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glGet
</span></span></a> with argument
<code class=
"constant">GL_MAX_EVAL_ORDER
</code>
410 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_VERTEX_3
</code>
412 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_VERTEX_4
</code>
414 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_INDEX
</code>
416 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_COLOR_4
</code>
418 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_NORMAL
</code>
420 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_TEXTURE_COORD_1
</code>
422 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_TEXTURE_COORD_2
</code>
424 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_TEXTURE_COORD_3
</code>
426 <a class=
"citerefentry" href=
"glIsEnabled.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glIsEnabled
</span></span></a> with argument
<code class=
"constant">GL_MAP1_TEXTURE_COORD_4
</code>
427 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"seealso"></a><h2>See Also
</h2><p>
428 <a class=
"citerefentry" href=
"glBegin.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glBegin
</span></span></a>,
429 <a class=
"citerefentry" href=
"glColor.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glColor
</span></span></a>,
430 <a class=
"citerefentry" href=
"glEnable.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEnable
</span></span></a>,
431 <a class=
"citerefentry" href=
"glEvalCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalCoord
</span></span></a>,
432 <a class=
"citerefentry" href=
"glEvalMesh.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalMesh
</span></span></a>,
433 <a class=
"citerefentry" href=
"glEvalPoint.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glEvalPoint
</span></span></a>,
434 <a class=
"citerefentry" href=
"glMap2.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glMap2
</span></span></a>,
435 <a class=
"citerefentry" href=
"glMapGrid.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glMapGrid
</span></span></a>,
436 <a class=
"citerefentry" href=
"glNormal.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glNormal
</span></span></a>,
437 <a class=
"citerefentry" href=
"glTexCoord.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glTexCoord
</span></span></a>,
438 <a class=
"citerefentry" href=
"glVertex.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glVertex
</span></span></a>
439 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"Copyright"></a><h2>Copyright
</h2><p>
440 Copyright
<span class=
"trademark"></span>©
1991-
2006
441 Silicon Graphics, Inc. This document is licensed under the SGI
442 Free Software B License. For details, see
443 <a class=
"ulink" href=
"http://oss.sgi.com/projects/FreeB/" target=
"_top">http://oss.sgi.com/projects/FreeB/
</a>.
444 </p></div></div></body></html>