1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"glTexEnv">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glTexEnv
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glTexEnv
</refname>
17 <refpurpose>set texture environment parameters
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glTexEnvf
</function></funcdef>
23 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
24 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
25 <paramdef>GLfloat
<parameter>param
</parameter></paramdef>
31 <funcdef>void
<function>glTexEnvi
</function></funcdef>
32 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
33 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
34 <paramdef>GLint
<parameter>param
</parameter></paramdef>
38 <!-- eqn: ignoring delim $$ -->
39 <refsect1 id=
"parameters"><title>Parameters
</title>
42 <term><parameter>target
</parameter></term>
45 Specifies a texture environment.
46 May be
<constant>GL_TEXTURE_ENV
</constant>,
<constant>GL_TEXTURE_FILTER_CONTROL
</constant> or
<constant>GL_POINT_SPRITE
</constant>.
51 <term><parameter>pname
</parameter></term>
54 Specifies the symbolic name of a single-valued texture environment parameter.
55 May be either
<constant>GL_TEXTURE_ENV_MODE
</constant>,
<constant>GL_TEXTURE_LOD_BIAS
</constant>,
56 <constant>GL_COMBINE_RGB
</constant>,
57 <constant>GL_COMBINE_ALPHA
</constant>,
58 <constant>GL_SRC0_RGB
</constant>,
59 <constant>GL_SRC1_RGB
</constant>,
60 <constant>GL_SRC2_RGB
</constant>,
61 <constant>GL_SRC0_ALPHA
</constant>,
62 <constant>GL_SRC1_ALPHA
</constant>,
63 <constant>GL_SRC2_ALPHA
</constant>,
64 <constant>GL_OPERAND0_RGB
</constant>,
65 <constant>GL_OPERAND1_RGB
</constant>,
66 <constant>GL_OPERAND2_RGB
</constant>,
67 <constant>GL_OPERAND0_ALPHA
</constant>,
68 <constant>GL_OPERAND1_ALPHA
</constant>,
69 <constant>GL_OPERAND2_ALPHA
</constant>,
70 <constant>GL_RGB_SCALE
</constant>,
71 <constant>GL_ALPHA_SCALE
</constant>, or
72 <constant>GL_COORD_REPLACE
</constant>.
77 <term><parameter>param
</parameter></term>
80 Specifies a single symbolic constant, one of
<constant>GL_ADD
</constant>,
81 <constant>GL_ADD_SIGNED
</constant>,
<constant>GL_INTERPOLATE
</constant>,
<constant>GL_MODULATE
</constant>,
<constant>GL_DECAL
</constant>,
82 <constant>GL_BLEND
</constant>,
<constant>GL_REPLACE
</constant>,
<constant>GL_SUBTRACT
</constant>,
<constant>GL_COMBINE
</constant>,
83 <constant>GL_TEXTURE
</constant>,
<constant>GL_CONSTANT
</constant>,
<constant>GL_PRIMARY_COLOR
</constant>,
<constant>GL_PREVIOUS
</constant>,
84 <constant>GL_SRC_COLOR
</constant>,
<constant>GL_ONE_MINUS_SRC_COLOR
</constant>,
<constant>GL_SRC_ALPHA
</constant>,
85 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>,
86 a single boolean value for the point sprite texture coordinate replacement,
87 a single floating-point value for the texture level-of-detail bias,
88 or
1.0,
2.0, or
4.0 when specifying the
<constant>GL_RGB_SCALE
</constant> or
<constant>GL_ALPHA_SCALE
</constant>.
94 <refsynopsisdiv><title>C Specification
</title>
97 <funcdef>void
<function>glTexEnvfv
</function></funcdef>
98 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
99 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
100 <paramdef>const GLfloat *
<parameter>params
</parameter></paramdef>
105 <funcdef>void
<function>glTexEnviv
</function></funcdef>
106 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
107 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
108 <paramdef>const GLint *
<parameter>params
</parameter></paramdef>
112 <refsect1 id=
"parameters2"><title>Parameters
</title>
115 <term><parameter>target
</parameter></term>
118 Specifies a texture environment.
119 May be either
<constant>GL_TEXTURE_ENV
</constant>, or
<constant>GL_TEXTURE_FILTER_CONTROL
</constant>.
124 <term><parameter>pname
</parameter></term>
127 Specifies the symbolic name of a texture environment parameter.
128 Accepted values are
<constant>GL_TEXTURE_ENV_MODE
</constant>,
<constant>GL_TEXTURE_ENV_COLOR
</constant>, or
129 <constant>GL_TEXTURE_LOD_BIAS
</constant>.
134 <term><parameter>params
</parameter></term>
137 Specifies a pointer to a parameter array that contains
138 either a single symbolic constant, single floating-point number, or an RGBA
145 <refsect1 id=
"description"><title>Description
</title>
147 A texture environment specifies how texture values are interpreted when a
148 fragment is textured. When
<parameter>target
</parameter> is
<constant>GL_TEXTURE_FILTER_CONTROL
</constant>,
149 <parameter>pname
</parameter> must be
<constant>GL_TEXTURE_LOD_BIAS
</constant>. When
<parameter>target
</parameter> is
150 <constant>GL_TEXTURE_ENV
</constant>,
<parameter>pname
</parameter> can be
<constant>GL_TEXTURE_ENV_MODE
</constant>,
151 <constant>GL_TEXTURE_ENV_COLOR
</constant>,
<constant>GL_COMBINE_RGB
</constant>,
<constant>GL_COMBINE_ALPHA
</constant>,
152 <constant>GL_RGB_SCALE
</constant>,
<constant>GL_ALPHA_SCALE
</constant>,
153 <constant>GL_SRC0_RGB
</constant>,
<constant>GL_SRC1_RGB
</constant>,
<constant>GL_SRC2_RGB
</constant>,
154 <constant>GL_SRC0_ALPHA
</constant>,
<constant>GL_SRC1_ALPHA
</constant>, or
<constant>GL_SRC2_ALPHA
</constant>.
157 If
<parameter>pname
</parameter> is
<constant>GL_TEXTURE_ENV_MODE
</constant>,
158 then
<parameter>params
</parameter> is (or points to) the symbolic name of a texture function.
159 Six texture functions may be specified:
160 <constant>GL_ADD
</constant>,
161 <constant>GL_MODULATE
</constant>,
162 <constant>GL_DECAL
</constant>,
163 <constant>GL_BLEND
</constant>,
164 <constant>GL_REPLACE
</constant>, or
165 <constant>GL_COMBINE
</constant>.
168 The following table shows the correspondence of filtered texture
170 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">R
</mml:mi>
171 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
172 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">G
</mml:mi>
173 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
174 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
175 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
176 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
177 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
178 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
179 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
180 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">I
</mml:mi>
181 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
182 to texture source components.
183 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
184 <mml:mi mathvariant=
"italic">s
</mml:mi></mml:msub></mml:math></inlineequation>
186 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
187 <mml:mi mathvariant=
"italic">s
</mml:mi></mml:msub></mml:math></inlineequation>
188 are used by the texture functions described below.
192 <informaltable frame=
"topbot">
193 <tgroup cols=
"3" align=
"left">
198 <entry rowsep=
"1" align=
"left">
199 Texture Base Internal Format
201 <entry rowsep=
"1" align=
"center">
202 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"bold-italic">C
</mml:mi>
203 <mml:mi mathvariant=
"italic">s
</mml:mi></mml:msub></mml:math></inlineequation>
205 <entry rowsep=
"1" align=
"center">
206 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"bold-italic">A
</mml:mi>
207 <mml:mi mathvariant=
"italic">s
</mml:mi></mml:msub></mml:math></inlineequation>
214 <constant>GL_ALPHA
</constant>
220 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
221 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
226 <constant>GL_LUMINANCE
</constant>
230 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
231 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
232 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
233 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
234 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
235 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
244 <constant>GL_LUMINANCE_ALPHA
</constant>
248 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
249 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
250 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
251 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
252 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">L
</mml:mi>
253 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
257 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
258 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
263 <constant>GL_INTENSITY
</constant>
267 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">I
</mml:mi>
268 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
269 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">I
</mml:mi>
270 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
271 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">I
</mml:mi>
272 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
276 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">I
</mml:mi>
277 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
282 <constant>GL_RGB
</constant>
286 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">R
</mml:mi>
287 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
288 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">G
</mml:mi>
289 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
290 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
291 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
300 <constant>GL_RGBA
</constant>
304 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">R
</mml:mi>
305 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
306 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">G
</mml:mi>
307 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>,
308 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">B
</mml:mi>
309 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
313 <inlineequation><mml:math><mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
314 <mml:mi mathvariant=
"italic">t
</mml:mi></mml:msub></mml:math></inlineequation>
321 A texture function acts on the fragment to be textured using
322 the texture image value that applies to the fragment
323 (see
<citerefentry><refentrytitle>glTexParameter
</refentrytitle></citerefentry>)
324 and produces an RGBA color for that fragment.
325 The following table shows how the RGBA color is produced for each
326 of the first five texture functions that can be chosen.
327 <inlineequation><mml:math><mml:mi mathvariant=
"italic">C
</mml:mi></mml:math></inlineequation>
328 is a triple of color values (RGB) and
329 <inlineequation><mml:math><mml:mi mathvariant=
"italic">A
</mml:mi></mml:math></inlineequation>
330 is the associated alpha value.
331 RGBA values extracted from a texture image are in the range [
0,
1].
333 <inlineequation><mml:math><mml:mi mathvariant=
"italic">p
</mml:mi></mml:math></inlineequation>
334 refers to the color computed from the previous texture stage (or the incoming fragment if processing texture stage
0),
336 <inlineequation><mml:math><mml:mi mathvariant=
"italic">s
</mml:mi></mml:math></inlineequation>
337 to the texture source color,
339 <inlineequation><mml:math><mml:mi mathvariant=
"italic">c
</mml:mi></mml:math></inlineequation>
340 to the texture environment color,
342 <inlineequation><mml:math><mml:mi mathvariant=
"italic">v
</mml:mi></mml:math></inlineequation>
343 indicates a value produced by the texture function.
347 <informaltable pgwide=
"1" font-size=
"8pt" frame=
"topbot">
348 <tgroup cols=
"7" align=
"left">
349 <colspec colwidth=
"4.1*" align=
"center"/>
350 <colspec colwidth=
"1*" align=
"center"/>
351 <colspec colwidth=
"2.3*" align=
"center"/>
352 <colspec colwidth=
"2.7*" />
353 <colspec colwidth=
"3.4*" />
354 <colspec colwidth=
"3.5*" />
355 <colspec colwidth=
"1.4*" />
358 <entry rowsep=
"1" align=
"center">
359 Texture Base Internal Format
361 <entry rowsep=
"1" align=
"center">
362 <constant>Value
</constant>
364 <entry rowsep=
"1" align=
"center">
365 <constant>GL_REPLACE
</constant> Function
367 <entry rowsep=
"1" align=
"center">
368 <constant>GL_MODULATE
</constant> Function
370 <entry rowsep=
"1" align=
"center">
371 <constant>GL_DECAL
</constant> Function
373 <entry rowsep=
"1" align=
"center">
374 <constant>GL_BLEND
</constant> Function
376 <entry rowsep=
"1" align=
"center">
377 <constant>GL_ADD
</constant> Function
383 <entry align=
"center">
384 <constant>GL_ALPHA
</constant>
386 <entry align=
"center">
387 <inlineequation><mml:math>
388 <!-- eqn: C sub v = :-->
390 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
391 <mml:mi mathvariant=
"italic">v
</mml:mi>
395 </mml:math></inlineequation>
397 <entry align=
"center">
398 <inlineequation><mml:math>
399 <!-- eqn: C sub p:-->
401 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
402 <mml:mi mathvariant=
"italic">p
</mml:mi>
405 </mml:math></inlineequation>
407 <entry align=
"center">
408 <inlineequation><mml:math>
409 <!-- eqn: C sub p:-->
411 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
412 <mml:mi mathvariant=
"italic">p
</mml:mi>
415 </mml:math></inlineequation>
417 <entry align=
"center">
420 <entry align=
"center">
421 <inlineequation><mml:math>
422 <!-- eqn: C sub v = C sub p:-->
424 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
425 <mml:mi mathvariant=
"italic">p
</mml:mi>
428 </mml:math></inlineequation>
430 <entry align=
"center">
431 <inlineequation><mml:math>
432 <!-- eqn: C sub v = C sub p:-->
434 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
435 <mml:mi mathvariant=
"italic">p
</mml:mi>
438 </mml:math></inlineequation>
442 <entry align=
"center">
444 <entry align=
"center">
445 <inlineequation><mml:math>
446 <!-- eqn: A sub v = :-->
448 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
449 <mml:mi mathvariant=
"italic">v
</mml:mi>
453 </mml:math></inlineequation>
455 <entry align=
"center">
456 <inlineequation><mml:math>
457 <!-- eqn: A sub v = A sub s:-->
459 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
460 <mml:mi mathvariant=
"italic">s
</mml:mi>
463 </mml:math></inlineequation>
465 <entry align=
"center">
466 <inlineequation><mml:math>
467 <!-- eqn: A sub v = A sub p A sub s:-->
470 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
471 <mml:mi mathvariant=
"italic">p
</mml:mi>
473 <mml:mo>⁢</mml:mo>
474 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
475 <mml:mi mathvariant=
"italic">s
</mml:mi>
479 </mml:math></inlineequation>
481 <entry align=
"center">
483 <entry align=
"center">
484 <inlineequation><mml:math>
485 <!-- eqn: A sub v = A sub p A sub s:-->
487 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
488 <mml:mi mathvariant=
"italic">v
</mml:mi>
492 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
493 <mml:mi mathvariant=
"italic">p
</mml:mi>
495 <mml:mo>⁢</mml:mo>
496 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
497 <mml:mi mathvariant=
"italic">s
</mml:mi>
501 </mml:math></inlineequation>
503 <entry align=
"center">
504 <inlineequation><mml:math>
505 <!-- eqn: A sub v = A sub p A sub s:-->
508 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
509 <mml:mi mathvariant=
"italic">p
</mml:mi>
511 <mml:mo>⁢</mml:mo>
512 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
513 <mml:mi mathvariant=
"italic">s
</mml:mi>
517 </mml:math></inlineequation>
521 <entry align=
"center">
522 <constant>GL_LUMINANCE
</constant>
524 <entry align=
"center">
525 <inlineequation><mml:math>
526 <!-- eqn: C sub v = :-->
528 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
529 <mml:mi mathvariant=
"italic">v
</mml:mi>
533 </mml:math></inlineequation>
535 <entry align=
"center">
536 <inlineequation><mml:math>
537 <!-- eqn: C sub v = C sub s:-->
539 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
540 <mml:mi mathvariant=
"italic">s
</mml:mi>
543 </mml:math></inlineequation>
545 <entry align=
"center">
546 <inlineequation><mml:math>
547 <!-- eqn: C sub v = C sub p C sub s:-->
550 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
551 <mml:mi mathvariant=
"italic">p
</mml:mi>
553 <mml:mo>⁢</mml:mo>
554 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
555 <mml:mi mathvariant=
"italic">s
</mml:mi>
559 </mml:math></inlineequation>
561 <entry align=
"center">
564 <entry align=
"center">
565 <inlineequation><mml:math>
566 <!-- eqn: C sub v = C sub p ( 1 - C sub s ) + C sub c C sub s:-->
569 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
570 <mml:mi mathvariant=
"italic">p
</mml:mi>
572 <mml:mo>⁢</mml:mo>
573 <mml:mfenced open=
"(" close=
")">
577 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
578 <mml:mi mathvariant=
"italic">s
</mml:mi>
583 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
584 <mml:mi mathvariant=
"italic">c
</mml:mi>
586 <mml:mo>⁢</mml:mo>
587 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
588 <mml:mi mathvariant=
"italic">s
</mml:mi>
592 </mml:math></inlineequation>
594 <entry align=
"center">
595 <inlineequation><mml:math>
596 <!-- eqn: C sub v = C sub p + C sub s:-->
599 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
600 <mml:mi mathvariant=
"italic">p
</mml:mi>
603 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
604 <mml:mi mathvariant=
"italic">s
</mml:mi>
608 </mml:math></inlineequation>
612 <entry align=
"center">
615 <entry align=
"center">
616 <inlineequation><mml:math>
617 <!-- eqn: A sub v = :-->
619 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
620 <mml:mi mathvariant=
"italic">v
</mml:mi>
624 </mml:math></inlineequation>
626 <entry align=
"center">
627 <inlineequation><mml:math>
628 <!-- eqn: A sub v = A sub p:-->
630 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
631 <mml:mi mathvariant=
"italic">p
</mml:mi>
634 </mml:math></inlineequation>
636 <entry align=
"center">
637 <inlineequation><mml:math>
638 <!-- eqn: A sub v = A sub p:-->
640 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
641 <mml:mi mathvariant=
"italic">p
</mml:mi>
644 </mml:math></inlineequation>
646 <entry align=
"center">
648 <entry align=
"center">
649 <inlineequation><mml:math>
650 <!-- eqn: A sub v = A sub p:-->
652 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
653 <mml:mi mathvariant=
"italic">p
</mml:mi>
656 </mml:math></inlineequation>
658 <entry align=
"center">
659 <inlineequation><mml:math>
660 <!-- eqn: A sub v = A sub p:-->
662 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
663 <mml:mi mathvariant=
"italic">p
</mml:mi>
666 </mml:math></inlineequation>
670 <entry align=
"center">
671 <constant>GL_LUMINANCE_ALPHA
</constant>
673 <entry align=
"center">
674 <inlineequation><mml:math>
675 <!-- eqn: C sub v = :-->
677 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
678 <mml:mi mathvariant=
"italic">v
</mml:mi>
682 </mml:math></inlineequation>
684 <entry align=
"center">
685 <inlineequation><mml:math>
686 <!-- eqn: C sub v = C sub s:-->
688 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
689 <mml:mi mathvariant=
"italic">s
</mml:mi>
692 </mml:math></inlineequation>
694 <entry align=
"center">
695 <inlineequation><mml:math>
696 <!-- eqn: C sub v = C sub p C sub s:-->
699 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
700 <mml:mi mathvariant=
"italic">p
</mml:mi>
702 <mml:mo>⁢</mml:mo>
703 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
704 <mml:mi mathvariant=
"italic">s
</mml:mi>
708 </mml:math></inlineequation>
710 <entry align=
"center">
713 <entry align=
"center">
714 <inlineequation><mml:math>
715 <!-- eqn: C sub v = C sub p ( 1 - C sub s ) + C sub c C sub s:-->
718 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
719 <mml:mi mathvariant=
"italic">p
</mml:mi>
721 <mml:mo>⁢</mml:mo>
722 <mml:mfenced open=
"(" close=
")">
726 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
727 <mml:mi mathvariant=
"italic">s
</mml:mi>
732 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
733 <mml:mi mathvariant=
"italic">c
</mml:mi>
735 <mml:mo>⁢</mml:mo>
736 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
737 <mml:mi mathvariant=
"italic">s
</mml:mi>
741 </mml:math></inlineequation>
743 <entry align=
"center">
744 <inlineequation><mml:math>
745 <!-- eqn: C sub v = C sub p + C sub s:-->
748 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
749 <mml:mi mathvariant=
"italic">p
</mml:mi>
752 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
753 <mml:mi mathvariant=
"italic">s
</mml:mi>
757 </mml:math></inlineequation>
761 <entry align=
"center">
764 <entry align=
"center">
765 <inlineequation><mml:math>
766 <!-- eqn: A sub v = :-->
768 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
769 <mml:mi mathvariant=
"italic">v
</mml:mi>
773 </mml:math></inlineequation>
775 <entry align=
"center">
776 <inlineequation><mml:math>
777 <!-- eqn: A sub v = A sub s:-->
779 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
780 <mml:mi mathvariant=
"italic">s
</mml:mi>
783 </mml:math></inlineequation>
785 <entry align=
"center">
786 <inlineequation><mml:math>
787 <!-- eqn: A sub v = A sub p A sub s:-->
790 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
791 <mml:mi mathvariant=
"italic">p
</mml:mi>
793 <mml:mo>⁢</mml:mo>
794 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
795 <mml:mi mathvariant=
"italic">s
</mml:mi>
799 </mml:math></inlineequation>
801 <entry align=
"center">
803 <entry align=
"center">
804 <inlineequation><mml:math>
805 <!-- eqn: A sub v = A sub p A sub s:-->
808 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
809 <mml:mi mathvariant=
"italic">p
</mml:mi>
811 <mml:mo>⁢</mml:mo>
812 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
813 <mml:mi mathvariant=
"italic">s
</mml:mi>
817 </mml:math></inlineequation>
819 <entry align=
"center">
820 <inlineequation><mml:math>
821 <!-- eqn: A sub v = A sub p A sub s:-->
824 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
825 <mml:mi mathvariant=
"italic">p
</mml:mi>
827 <mml:mo>⁢</mml:mo>
828 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
829 <mml:mi mathvariant=
"italic">s
</mml:mi>
833 </mml:math></inlineequation>
837 <entry align=
"center">
838 <constant>GL_INTENSITY
</constant>
840 <entry align=
"center">
841 <inlineequation><mml:math>
842 <!-- eqn: C sub v = :-->
844 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
845 <mml:mi mathvariant=
"italic">v
</mml:mi>
849 </mml:math></inlineequation>
851 <entry align=
"center">
852 <inlineequation><mml:math>
853 <!-- eqn: C sub v = C sub s:-->
855 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
856 <mml:mi mathvariant=
"italic">s
</mml:mi>
859 </mml:math></inlineequation>
861 <entry align=
"center">
862 <inlineequation><mml:math>
863 <!-- eqn: C sub v = C sub p C sub s:-->
866 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
867 <mml:mi mathvariant=
"italic">p
</mml:mi>
869 <mml:mo>⁢</mml:mo>
870 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
871 <mml:mi mathvariant=
"italic">s
</mml:mi>
875 </mml:math></inlineequation>
877 <entry align=
"center">
880 <entry align=
"center">
881 <inlineequation><mml:math>
882 <!-- eqn: C sub v = C sub p ( 1 - C sub s ) + C sub c C sub s:-->
885 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
886 <mml:mi mathvariant=
"italic">p
</mml:mi>
888 <mml:mo>⁢</mml:mo>
889 <mml:mfenced open=
"(" close=
")">
893 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
894 <mml:mi mathvariant=
"italic">s
</mml:mi>
899 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
900 <mml:mi mathvariant=
"italic">c
</mml:mi>
902 <mml:mo>⁢</mml:mo>
903 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
904 <mml:mi mathvariant=
"italic">s
</mml:mi>
908 </mml:math></inlineequation>
910 <entry align=
"center">
911 <inlineequation><mml:math>
912 <!-- eqn: C sub v = C sub p + C sub s:-->
915 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
916 <mml:mi mathvariant=
"italic">p
</mml:mi>
919 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
920 <mml:mi mathvariant=
"italic">s
</mml:mi>
924 </mml:math></inlineequation>
928 <entry align=
"center">
930 <entry align=
"center">
931 <inlineequation><mml:math>
932 <!-- eqn: A sub v = :-->
934 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
935 <mml:mi mathvariant=
"italic">v
</mml:mi>
939 </mml:math></inlineequation>
941 <entry align=
"center">
942 <inlineequation><mml:math>
943 <!-- eqn: A sub v = A sub s:-->
945 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
946 <mml:mi mathvariant=
"italic">s
</mml:mi>
949 </mml:math></inlineequation>
951 <entry align=
"center">
952 <inlineequation><mml:math>
953 <!-- eqn: A sub v = A sub p A sub s:-->
956 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
957 <mml:mi mathvariant=
"italic">p
</mml:mi>
959 <mml:mo>⁢</mml:mo>
960 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
961 <mml:mi mathvariant=
"italic">s
</mml:mi>
965 </mml:math></inlineequation>
967 <entry align=
"center">
969 <entry align=
"center">
970 <inlineequation><mml:math>
971 <!-- eqn: A sub v = A sub p ( 1 - A sub s ) + A sub c A sub s:-->
974 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
975 <mml:mi mathvariant=
"italic">p
</mml:mi>
977 <mml:mo>⁢</mml:mo>
978 <mml:mfenced open=
"(" close=
")">
982 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
983 <mml:mi mathvariant=
"italic">s
</mml:mi>
988 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
989 <mml:mi mathvariant=
"italic">c
</mml:mi>
991 <mml:mo>⁢</mml:mo>
992 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
993 <mml:mi mathvariant=
"italic">s
</mml:mi>
997 </mml:math></inlineequation>
999 <entry align=
"center">
1000 <inlineequation><mml:math>
1001 <!-- eqn: A sub v = A sub p + A sub s:-->
1004 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1005 <mml:mi mathvariant=
"italic">p
</mml:mi>
1008 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1009 <mml:mi mathvariant=
"italic">s
</mml:mi>
1013 </mml:math></inlineequation>
1017 <entry align=
"center">
1018 <constant>GL_RGB
</constant>
1020 <entry align=
"center">
1021 <inlineequation><mml:math>
1022 <!-- eqn: C sub v = :-->
1024 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1025 <mml:mi mathvariant=
"italic">v
</mml:mi>
1029 </mml:math></inlineequation>
1031 <entry align=
"center">
1032 <inlineequation><mml:math>
1033 <!-- eqn: C sub v = C sub s:-->
1035 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1036 <mml:mi mathvariant=
"italic">s
</mml:mi>
1039 </mml:math></inlineequation>
1041 <entry align=
"center">
1042 <inlineequation><mml:math>
1043 <!-- eqn: C sub v = C sub p C sub s:-->
1046 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1047 <mml:mi mathvariant=
"italic">p
</mml:mi>
1049 <mml:mo>⁢</mml:mo>
1050 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1051 <mml:mi mathvariant=
"italic">s
</mml:mi>
1055 </mml:math></inlineequation>
1057 <entry align=
"center">
1058 <inlineequation><mml:math>
1059 <!-- eqn: C sub v = C sub s:-->
1061 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1062 <mml:mi mathvariant=
"italic">s
</mml:mi>
1065 </mml:math></inlineequation>
1067 <entry align=
"center">
1068 <inlineequation><mml:math>
1069 <!-- eqn: C sub v = C sub p ( 1 - C sub s ) + C sub c C sub s:-->
1072 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1073 <mml:mi mathvariant=
"italic">p
</mml:mi>
1075 <mml:mo>⁢</mml:mo>
1076 <mml:mfenced open=
"(" close=
")">
1080 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1081 <mml:mi mathvariant=
"italic">s
</mml:mi>
1086 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1087 <mml:mi mathvariant=
"italic">c
</mml:mi>
1089 <mml:mo>⁢</mml:mo>
1090 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1091 <mml:mi mathvariant=
"italic">s
</mml:mi>
1095 </mml:math></inlineequation>
1097 <entry align=
"center">
1098 <inlineequation><mml:math>
1099 <!-- eqn: C sub v = C sub p + C sub s:-->
1102 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1103 <mml:mi mathvariant=
"italic">p
</mml:mi>
1106 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1107 <mml:mi mathvariant=
"italic">s
</mml:mi>
1111 </mml:math></inlineequation>
1115 <entry align=
"center">
1118 <entry align=
"center">
1119 <inlineequation><mml:math>
1120 <!-- eqn: A sub v = :-->
1122 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1123 <mml:mi mathvariant=
"italic">v
</mml:mi>
1127 </mml:math></inlineequation>
1129 <entry align=
"center">
1130 <inlineequation><mml:math>
1131 <!-- eqn: A sub v = A sub p:-->
1133 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1134 <mml:mi mathvariant=
"italic">p
</mml:mi>
1137 </mml:math></inlineequation>
1139 <entry align=
"center">
1140 <inlineequation><mml:math>
1141 <!-- eqn: A sub v = A sub p:-->
1143 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1144 <mml:mi mathvariant=
"italic">p
</mml:mi>
1147 </mml:math></inlineequation>
1149 <entry align=
"center">
1150 <inlineequation><mml:math>
1151 <!-- eqn: A sub v = A sub p:-->
1153 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1154 <mml:mi mathvariant=
"italic">p
</mml:mi>
1157 </mml:math></inlineequation>
1159 <entry align=
"center">
1160 <inlineequation><mml:math>
1161 <!-- eqn: A sub v = A sub p:-->
1163 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1164 <mml:mi mathvariant=
"italic">p
</mml:mi>
1167 </mml:math></inlineequation>
1169 <entry align=
"center">
1170 <inlineequation><mml:math>
1171 <!-- eqn: A sub v = A sub p:-->
1173 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1174 <mml:mi mathvariant=
"italic">p
</mml:mi>
1177 </mml:math></inlineequation>
1181 <entry align=
"center">
1182 <constant>GL_RGBA
</constant>
1184 <entry align=
"center">
1185 <inlineequation><mml:math>
1186 <!-- eqn: C sub v = :-->
1188 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1189 <mml:mi mathvariant=
"italic">v
</mml:mi>
1193 </mml:math></inlineequation>
1195 <entry align=
"center">
1196 <inlineequation><mml:math>
1197 <!-- eqn: C sub v = C sub s:-->
1199 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1200 <mml:mi mathvariant=
"italic">s
</mml:mi>
1203 </mml:math></inlineequation>
1205 <entry align=
"center">
1206 <inlineequation><mml:math>
1207 <!-- eqn: C sub v = C sub p C sub s:-->
1210 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1211 <mml:mi mathvariant=
"italic">p
</mml:mi>
1213 <mml:mo>⁢</mml:mo>
1214 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1215 <mml:mi mathvariant=
"italic">s
</mml:mi>
1219 </mml:math></inlineequation>
1221 <entry align=
"center">
1222 <inlineequation><mml:math>
1223 <!-- eqn: C sub v = C sub p ( 1 - A sub s ) + C sub s A sub s:-->
1226 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1227 <mml:mi mathvariant=
"italic">p
</mml:mi>
1229 <mml:mo>⁢</mml:mo>
1230 <mml:mfenced open=
"(" close=
")">
1234 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1235 <mml:mi mathvariant=
"italic">s
</mml:mi>
1240 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1241 <mml:mi mathvariant=
"italic">s
</mml:mi>
1243 <mml:mo>⁢</mml:mo>
1244 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1245 <mml:mi mathvariant=
"italic">s
</mml:mi>
1249 </mml:math></inlineequation>
1251 <entry align=
"center">
1252 <inlineequation><mml:math>
1253 <!-- eqn: C sub v = C sub p ( 1 - C sub s ) + C sub c C sub s:-->
1256 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1257 <mml:mi mathvariant=
"italic">p
</mml:mi>
1259 <mml:mo>⁢</mml:mo>
1260 <mml:mfenced open=
"(" close=
")">
1264 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1265 <mml:mi mathvariant=
"italic">s
</mml:mi>
1270 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1271 <mml:mi mathvariant=
"italic">c
</mml:mi>
1273 <mml:mo>⁢</mml:mo>
1274 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1275 <mml:mi mathvariant=
"italic">s
</mml:mi>
1279 </mml:math></inlineequation>
1281 <entry align=
"center">
1282 <inlineequation><mml:math>
1283 <!-- eqn: C sub v = C sub p + C sub s:-->
1286 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1287 <mml:mi mathvariant=
"italic">p
</mml:mi>
1290 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1291 <mml:mi mathvariant=
"italic">s
</mml:mi>
1295 </mml:math></inlineequation>
1299 <entry align=
"center">
1302 <entry align=
"center">
1303 <inlineequation><mml:math>
1304 <!-- eqn: A sub v = :-->
1306 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1307 <mml:mi mathvariant=
"italic">v
</mml:mi>
1311 </mml:math></inlineequation>
1313 <entry align=
"center">
1314 <inlineequation><mml:math>
1315 <!-- eqn: A sub v = A sub s:-->
1317 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1318 <mml:mi mathvariant=
"italic">s
</mml:mi>
1321 </mml:math></inlineequation>
1323 <entry align=
"center">
1324 <inlineequation><mml:math>
1325 <!-- eqn: A sub v = A sub p A sub s:-->
1328 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1329 <mml:mi mathvariant=
"italic">p
</mml:mi>
1331 <mml:mo>⁢</mml:mo>
1332 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1333 <mml:mi mathvariant=
"italic">s
</mml:mi>
1337 </mml:math></inlineequation>
1339 <entry align=
"center">
1340 <inlineequation><mml:math>
1341 <!-- eqn: A sub v = A sub p:-->
1343 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1344 <mml:mi mathvariant=
"italic">p
</mml:mi>
1347 </mml:math></inlineequation>
1349 <entry align=
"center">
1350 <inlineequation><mml:math>
1351 <!-- eqn: A sub v = A sub p A sub s:-->
1354 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1355 <mml:mi mathvariant=
"italic">p
</mml:mi>
1357 <mml:mo>⁢</mml:mo>
1358 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1359 <mml:mi mathvariant=
"italic">s
</mml:mi>
1363 </mml:math></inlineequation>
1365 <entry align=
"center">
1366 <inlineequation><mml:math>
1367 <!-- eqn: A sub v = A sub p A sub s:-->
1370 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1371 <mml:mi mathvariant=
"italic">p
</mml:mi>
1373 <mml:mo>⁢</mml:mo>
1374 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1375 <mml:mi mathvariant=
"italic">s
</mml:mi>
1379 </mml:math></inlineequation>
1386 If
<parameter>pname
</parameter> is
<constant>GL_TEXTURE_ENV_MODE
</constant>, and
<parameter>params
</parameter> is
<constant>GL_COMBINE
</constant>, the
1387 form of the texture function depends on the values of
<constant>GL_COMBINE_RGB
</constant>
1388 and
<constant>GL_COMBINE_ALPHA
</constant>.
1391 The following describes how the texture sources, as specified by
1392 <constant>GL_SRC0_RGB
</constant>,
<constant>GL_SRC1_RGB
</constant>,
<constant>GL_SRC2_RGB
</constant>,
1393 <constant>GL_SRC0_ALPHA
</constant>,
<constant>GL_SRC1_ALPHA
</constant>, and
<constant>GL_SRC2_ALPHA
</constant>,
1394 are combined to produce a final texture color. In the following tables,
1395 <constant>GL_SRC0_c
</constant> is represented by
1396 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg0
</mml:mi></mml:math></inlineequation>,
1397 <constant>GL_SRC1_c
</constant> is
1399 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg1
</mml:mi></mml:math></inlineequation>,
1400 and
<constant>GL_SRC2_c
</constant> is represented by
1401 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg2
</mml:mi></mml:math></inlineequation>.
1404 <constant>GL_COMBINE_RGB
</constant> accepts any of
<constant>GL_REPLACE
</constant>,
<constant>GL_MODULATE
</constant>,
1405 <constant>GL_ADD
</constant>,
<constant>GL_ADD_SIGNED
</constant>,
<constant>GL_INTERPOLATE
</constant>,
<constant>GL_SUBTRACT
</constant>,
1406 <constant>GL_DOT3_RGB
</constant>, or
<constant>GL_DOT3_RGBA
</constant>.
1410 <informaltable frame=
"topbot">
1411 <tgroup cols=
"2" align=
"left">
1416 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1417 <constant>GL_COMBINE_RGB
</constant>
1419 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1426 <entry align=
"left">
1427 <constant>GL_REPLACE
</constant>
1429 <entry align=
"left">
1430 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg0
</mml:mi></mml:math></inlineequation>
1434 <entry align=
"left">
1435 <constant>GL_MODULATE
</constant>
1437 <entry align=
"left">
1438 <inlineequation><mml:math>
1439 <!-- eqn: Arg0 * Arg1:-->
1441 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1442 <mml:mo>×</mml:mo>
1443 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1445 </mml:math></inlineequation>
1449 <entry align=
"left">
1450 <constant>GL_ADD
</constant>
1452 <entry align=
"left">
1453 <inlineequation><mml:math>
1454 <!-- eqn: Arg0 + Arg1:-->
1456 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1458 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1460 </mml:math></inlineequation>
1464 <entry align=
"left">
1465 <constant>GL_ADD_SIGNED
</constant>
1467 <entry align=
"left">
1468 <inlineequation><mml:math>
1469 <!-- eqn: Arg0 + Arg1 - 0.5:-->
1471 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1473 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1475 <mml:mn>0.5</mml:mn>
1477 </mml:math></inlineequation>
1481 <entry align=
"left">
1482 <constant>GL_INTERPOLATE
</constant>
1484 <entry align=
"left">
1485 <inlineequation><mml:math>
1486 <!-- eqn: Arg0 * Arg2 + Arg1*(1 - Arg2):-->
1489 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1490 <mml:mo>×</mml:mo>
1491 <mml:mi mathvariant=
"italic">Arg2
</mml:mi>
1495 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1496 <mml:mo>×</mml:mo>
1497 <mml:mfenced open=
"(" close=
")">
1501 <mml:mi mathvariant=
"italic">Arg2
</mml:mi>
1506 </mml:math></inlineequation>
1510 <entry align=
"left">
1511 <constant>GL_SUBTRACT
</constant>
1513 <entry align=
"left">
1514 <inlineequation><mml:math>
1515 <!-- eqn: Arg0 - Arg1:-->
1517 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1519 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1521 </mml:math></inlineequation>
1525 <entry align=
"left">
1526 <constant>GL_DOT3_RGB
</constant>
1528 <constant>GL_DOT3_RGBA
</constant>
1530 <entry align=
"left">
1531 <!-- eqn: 4 * ((({Arg0 sub r} - 0.5) * ({Arg1 sub r} - 0.5)) +
1532 (({Arg0 sub g} - 0.5) * ({Arg1 sub g} - 0.5)) +
1533 (({Arg0 sub b} - 0.5) * ({Arg1 sub b} - 0.5)):-->
1534 <inlineequation><mml:math>
1537 <mml:mo>×</mml:mo>
1538 <mml:mfenced open=
"(" close=
")">
1540 <mml:mfenced open=
"(" close=
")">
1542 <mml:mfenced open=
"(" close=
")">
1544 <mml:mfenced open=
"" close=
"">
1545 <mml:msub><mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1546 <mml:mi mathvariant=
"italic">r
</mml:mi>
1550 <mml:mn>0.5</mml:mn>
1553 <mml:mo>×</mml:mo>
1554 <mml:mfenced open=
"(" close=
")">
1556 <mml:mfenced open=
"" close=
"">
1557 <mml:msub><mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1558 <mml:mi mathvariant=
"italic">r
</mml:mi>
1562 <mml:mn>0.5</mml:mn>
1568 <mml:mfenced open=
"(" close=
")">
1570 <mml:mfenced open=
"(" close=
")">
1572 <mml:mfenced open=
"" close=
"">
1573 <mml:msub><mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1574 <mml:mi mathvariant=
"italic">g
</mml:mi>
1578 <mml:mn>0.5</mml:mn>
1581 <mml:mo>×</mml:mo>
1582 <mml:mfenced open=
"(" close=
")">
1584 <mml:mfenced open=
"" close=
"">
1585 <mml:msub><mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1586 <mml:mi mathvariant=
"italic">g
</mml:mi>
1590 <mml:mn>0.5</mml:mn>
1596 <mml:mfenced open=
"(" close=
")">
1598 <mml:mfenced open=
"(" close=
")">
1600 <mml:mfenced open=
"" close=
"">
1601 <mml:msub><mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1602 <mml:mi mathvariant=
"italic">b
</mml:mi>
1606 <mml:mn>0.5</mml:mn>
1609 <mml:mo>×</mml:mo>
1610 <mml:mfenced open=
"(" close=
")">
1612 <mml:mfenced open=
"" close=
"">
1613 <mml:msub><mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1614 <mml:mi mathvariant=
"italic">b
</mml:mi>
1618 <mml:mn>0.5</mml:mn>
1626 </mml:math></inlineequation>
1633 The scalar results for
<constant>GL_DOT3_RGB
</constant> and
<constant>GL_DOT3_RGBA
</constant> are placed
1634 into each of the
3 (RGB) or
4 (RGBA) components on output.
1637 Likewise,
<constant>GL_COMBINE_ALPHA
</constant> accepts any of
<constant>GL_REPLACE
</constant>,
1638 <constant>GL_MODULATE
</constant>,
<constant>GL_ADD
</constant>,
<constant>GL_ADD_SIGNED
</constant>,
<constant>GL_INTERPOLATE
</constant>, or
1639 <constant>GL_SUBTRACT
</constant>. The following table describes how alpha values are
1644 <informaltable frame=
"topbot">
1645 <tgroup cols=
"2" align=
"left">
1650 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1651 <constant>GL_COMBINE_ALPHA
</constant>
1653 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1660 <entry align=
"left">
1661 <constant>GL_REPLACE
</constant>
1663 <entry align=
"left">
1664 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg0
</mml:mi></mml:math></inlineequation>
1668 <entry align=
"left">
1669 <constant>GL_MODULATE
</constant>
1671 <entry align=
"left">
1672 <inlineequation><mml:math>
1673 <!-- eqn: Arg0 * Arg1:-->
1675 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1676 <mml:mo>×</mml:mo>
1677 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1679 </mml:math></inlineequation>
1683 <entry align=
"left">
1684 <constant>GL_ADD
</constant>
1686 <entry align=
"left">
1687 <inlineequation><mml:math>
1688 <!-- eqn: Arg0 + Arg1:-->
1690 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1692 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1694 </mml:math></inlineequation>
1698 <entry align=
"left">
1699 <constant>GL_ADD_SIGNED
</constant>
1701 <entry align=
"left">
1702 <inlineequation><mml:math>
1703 <!-- eqn: Arg0 + Arg1 - 0.5:-->
1705 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1707 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1709 <mml:mn>0.5</mml:mn>
1711 </mml:math></inlineequation>
1715 <entry align=
"left">
1716 <constant>GL_INTERPOLATE
</constant>
1718 <entry align=
"left">
1719 <inlineequation><mml:math>
1720 <!-- eqn: Arg0 * Arg2 + Arg1*(1 - Arg2):-->
1723 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1724 <mml:mo>×</mml:mo>
1725 <mml:mi mathvariant=
"italic">Arg2
</mml:mi>
1729 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1730 <mml:mo>×</mml:mo>
1731 <mml:mfenced open=
"(" close=
")">
1735 <mml:mi mathvariant=
"italic">Arg2
</mml:mi>
1740 </mml:math></inlineequation>
1744 <entry align=
"left">
1745 <constant>GL_SUBTRACT
</constant>
1747 <entry align=
"left">
1748 <inlineequation><mml:math>
1749 <!-- eqn: Arg0 - Arg1:-->
1751 <mml:mi mathvariant=
"italic">Arg0
</mml:mi>
1753 <mml:mi mathvariant=
"italic">Arg1
</mml:mi>
1755 </mml:math></inlineequation>
1762 In the following tables, the value
1763 <inlineequation><mml:math>
1764 <!-- eqn: C sub s:-->
1765 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1766 <mml:mi mathvariant=
"italic">s
</mml:mi>
1768 </mml:math></inlineequation>
1769 represents the color sampled
1770 from the currently bound texture,
1771 <inlineequation><mml:math>
1772 <!-- eqn: C sub c:-->
1773 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1774 <mml:mi mathvariant=
"italic">c
</mml:mi>
1776 </mml:math></inlineequation>
1777 represents the constant
1778 texture-environment color,
1779 <inlineequation><mml:math>
1780 <!-- eqn: C sub f:-->
1781 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1782 <mml:mi mathvariant=
"italic">f
</mml:mi>
1784 </mml:math></inlineequation>
1785 represents the primary color of the
1786 incoming fragment, and
1787 <inlineequation><mml:math>
1788 <!-- eqn: C sub p:-->
1789 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1790 <mml:mi mathvariant=
"italic">p
</mml:mi>
1792 </mml:math></inlineequation>
1793 represents the color computed from the
1794 previous texture stage or
1795 <inlineequation><mml:math>
1796 <!-- eqn: C sub f:-->
1797 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1798 <mml:mi mathvariant=
"italic">f
</mml:mi>
1800 </mml:math></inlineequation>
1801 if processing texture stage
0. Likewise,
1802 <inlineequation><mml:math>
1803 <!-- eqn: A sub s:-->
1804 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1805 <mml:mi mathvariant=
"italic">s
</mml:mi>
1807 </mml:math></inlineequation>,
1808 <inlineequation><mml:math>
1809 <!-- eqn: A sub c:-->
1810 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1811 <mml:mi mathvariant=
"italic">c
</mml:mi>
1813 </mml:math></inlineequation>,
1814 <inlineequation><mml:math>
1815 <!-- eqn: A sub f:-->
1816 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1817 <mml:mi mathvariant=
"italic">f
</mml:mi>
1819 </mml:math></inlineequation>,
1821 <inlineequation><mml:math>
1822 <!-- eqn: A sub p:-->
1823 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1824 <mml:mi mathvariant=
"italic">p
</mml:mi>
1826 </mml:math></inlineequation>
1827 represent the respective
1831 The following table describes the values assigned to
1832 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg0
</mml:mi></mml:math></inlineequation>,
1833 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg1
</mml:mi></mml:math></inlineequation>,
1835 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg2
</mml:mi></mml:math></inlineequation>
1836 based upon the RGB sources and operands:
1840 <informaltable frame=
"topbot">
1841 <tgroup cols=
"3" align=
"left">
1844 <colspec align=
"center"/>
1847 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1848 <constant>GL_SRCn_RGB
</constant>
1850 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
1851 <constant>GL_OPERANDn_RGB
</constant>
1853 <entry rowsep=
"1" align=
"center"><emphasis role=
"bold">
1860 <entry align=
"left">
1861 <constant>GL_TEXTURE
</constant>
1863 <entry align=
"left">
1864 <constant>GL_SRC_COLOR
</constant>
1866 <entry align=
"center">
1867 <inlineequation><mml:math>
1868 <!-- eqn: {C sub s}:-->
1869 <mml:mfenced open=
"" close=
"">
1870 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1871 <mml:mi mathvariant=
"italic">s
</mml:mi>
1874 </mml:math></inlineequation>
1878 <entry align=
"left">
1880 <entry align=
"left">
1881 <constant>GL_ONE_MINUS_SRC_COLOR
</constant>
1883 <entry align=
"center">
1884 <inlineequation><mml:math>
1885 <!-- eqn: 1 - {C sub s}:-->
1889 <mml:mfenced open=
"" close=
"">
1890 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1891 <mml:mi mathvariant=
"italic">s
</mml:mi>
1895 </mml:math></inlineequation>
1899 <entry align=
"left">
1901 <entry align=
"left">
1902 <constant>GL_SRC_ALPHA
</constant>
1904 <entry align=
"center">
1905 <inlineequation><mml:math>
1906 <!-- eqn: {A sub s}:-->
1907 <mml:mfenced open=
"" close=
"">
1908 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1909 <mml:mi mathvariant=
"italic">s
</mml:mi>
1912 </mml:math></inlineequation>
1916 <entry align=
"left">
1918 <entry align=
"left">
1919 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
1921 <entry align=
"center">
1922 <inlineequation><mml:math>
1923 <!-- eqn: 1 - {A sub s}:-->
1927 <mml:mfenced open=
"" close=
"">
1928 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1929 <mml:mi mathvariant=
"italic">s
</mml:mi>
1933 </mml:math></inlineequation>
1937 <entry align=
"left">
1938 <constant>GL_TEXTUREn
</constant>
1940 <entry align=
"left">
1941 <constant>GL_SRC_COLOR
</constant>
1943 <entry align=
"center">
1944 <inlineequation><mml:math>
1945 <!-- eqn: {C sub s}:-->
1946 <mml:mfenced open=
"" close=
"">
1947 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1948 <mml:mi mathvariant=
"italic">s
</mml:mi>
1951 </mml:math></inlineequation>
1955 <entry align=
"left">
1957 <entry align=
"left">
1958 <constant>GL_ONE_MINUS_SRC_COLOR
</constant>
1960 <entry align=
"center">
1961 <inlineequation><mml:math>
1962 <!-- eqn: 1 - {C sub s}:-->
1966 <mml:mfenced open=
"" close=
"">
1967 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
1968 <mml:mi mathvariant=
"italic">s
</mml:mi>
1972 </mml:math></inlineequation>
1976 <entry align=
"left">
1978 <entry align=
"left">
1979 <constant>GL_SRC_ALPHA
</constant>
1981 <entry align=
"center">
1982 <inlineequation><mml:math>
1983 <!-- eqn: {A sub s}:-->
1984 <mml:mfenced open=
"" close=
"">
1985 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
1986 <mml:mi mathvariant=
"italic">s
</mml:mi>
1989 </mml:math></inlineequation>
1993 <entry align=
"left">
1995 <entry align=
"left">
1996 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
1998 <entry align=
"center">
1999 <inlineequation><mml:math>
2000 <!-- eqn: 1 - {A sub s}:-->
2004 <mml:mfenced open=
"" close=
"">
2005 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2006 <mml:mi mathvariant=
"italic">s
</mml:mi>
2010 </mml:math></inlineequation>
2014 <entry align=
"left">
2015 <constant>GL_CONSTANT
</constant>
2017 <entry align=
"left">
2018 <constant>GL_SRC_COLOR
</constant>
2020 <entry align=
"center">
2021 <inlineequation><mml:math>
2022 <!-- eqn: {C sub c}:-->
2023 <mml:mfenced open=
"" close=
"">
2024 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2025 <mml:mi mathvariant=
"italic">c
</mml:mi>
2028 </mml:math></inlineequation>
2032 <entry align=
"left">
2034 <entry align=
"left">
2035 <constant>GL_ONE_MINUS_SRC_COLOR
</constant>
2037 <entry align=
"center">
2038 <inlineequation><mml:math>
2039 <!-- eqn: 1 - {C sub c}:-->
2043 <mml:mfenced open=
"" close=
"">
2044 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2045 <mml:mi mathvariant=
"italic">c
</mml:mi>
2049 </mml:math></inlineequation>
2053 <entry align=
"left">
2055 <entry align=
"left">
2056 <constant>GL_SRC_ALPHA
</constant>
2058 <entry align=
"center">
2059 <inlineequation><mml:math>
2060 <!-- eqn: {A sub c}:-->
2061 <mml:mfenced open=
"" close=
"">
2062 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2063 <mml:mi mathvariant=
"italic">c
</mml:mi>
2066 </mml:math></inlineequation>
2070 <entry align=
"left">
2072 <entry align=
"left">
2073 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2075 <entry align=
"center">
2076 <inlineequation><mml:math>
2077 <!-- eqn: 1 - {A sub c}:-->
2081 <mml:mfenced open=
"" close=
"">
2082 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2083 <mml:mi mathvariant=
"italic">c
</mml:mi>
2087 </mml:math></inlineequation>
2091 <entry align=
"left">
2092 <constant>GL_PRIMARY_COLOR
</constant>
2094 <entry align=
"left">
2095 <constant>GL_SRC_COLOR
</constant>
2097 <entry align=
"center">
2098 <inlineequation><mml:math>
2099 <!-- eqn: {C sub f}:-->
2100 <mml:mfenced open=
"" close=
"">
2101 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2102 <mml:mi mathvariant=
"italic">f
</mml:mi>
2105 </mml:math></inlineequation>
2109 <entry align=
"left">
2111 <entry align=
"left">
2112 <constant>GL_ONE_MINUS_SRC_COLOR
</constant>
2114 <entry align=
"center">
2115 <inlineequation><mml:math>
2116 <!-- eqn: 1 - {C sub f}:-->
2120 <mml:mfenced open=
"" close=
"">
2121 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2122 <mml:mi mathvariant=
"italic">f
</mml:mi>
2126 </mml:math></inlineequation>
2130 <entry align=
"left">
2132 <entry align=
"left">
2133 <constant>GL_SRC_ALPHA
</constant>
2135 <entry align=
"center">
2136 <inlineequation><mml:math>
2137 <!-- eqn: {A sub f}:-->
2138 <mml:mfenced open=
"" close=
"">
2139 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2140 <mml:mi mathvariant=
"italic">f
</mml:mi>
2143 </mml:math></inlineequation>
2147 <entry align=
"left">
2149 <entry align=
"left">
2150 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2152 <entry align=
"center">
2153 <inlineequation><mml:math>
2154 <!-- eqn: 1 - {A sub f}:-->
2158 <mml:mfenced open=
"" close=
"">
2159 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2160 <mml:mi mathvariant=
"italic">f
</mml:mi>
2164 </mml:math></inlineequation>
2168 <entry align=
"left">
2169 <constant>GL_PREVIOUS
</constant>
2171 <entry align=
"left">
2172 <constant>GL_SRC_COLOR
</constant>
2174 <entry align=
"center">
2175 <inlineequation><mml:math>
2176 <!-- eqn: {C sub p}:-->
2177 <mml:mfenced open=
"" close=
"">
2178 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2179 <mml:mi mathvariant=
"italic">p
</mml:mi>
2182 </mml:math></inlineequation>
2186 <entry align=
"left">
2188 <entry align=
"left">
2189 <constant>GL_ONE_MINUS_SRC_COLOR
</constant>
2191 <entry align=
"center">
2192 <inlineequation><mml:math>
2193 <!-- eqn: 1 - {C sub p}:-->
2197 <mml:mfenced open=
"" close=
"">
2198 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2199 <mml:mi mathvariant=
"italic">p
</mml:mi>
2203 </mml:math></inlineequation>
2207 <entry align=
"left">
2209 <entry align=
"left">
2210 <constant>GL_SRC_ALPHA
</constant>
2212 <entry align=
"center">
2213 <inlineequation><mml:math>
2214 <!-- eqn: {A sub p}:-->
2215 <mml:mfenced open=
"" close=
"">
2216 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2217 <mml:mi mathvariant=
"italic">p
</mml:mi>
2220 </mml:math></inlineequation>
2224 <entry align=
"left">
2226 <entry align=
"left">
2227 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2229 <entry align=
"center">
2230 <inlineequation><mml:math>
2231 <!-- eqn: 1 - {A sub p}:-->
2235 <mml:mfenced open=
"" close=
"">
2236 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2237 <mml:mi mathvariant=
"italic">p
</mml:mi>
2241 </mml:math></inlineequation>
2248 For
<constant>GL_TEXTUREn
</constant> sources,
2249 <inlineequation><mml:math>
2250 <!-- eqn: C sub s:-->
2251 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2252 <mml:mi mathvariant=
"italic">s
</mml:mi>
2254 </mml:math></inlineequation>
2256 <inlineequation><mml:math>
2257 <!-- eqn: A sub s:-->
2258 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2259 <mml:mi mathvariant=
"italic">s
</mml:mi>
2261 </mml:math></inlineequation>
2263 and alpha, respectively, produced from texture stage
2264 <inlineequation><mml:math><mml:mi mathvariant=
"italic">n
</mml:mi></mml:math></inlineequation>.
2267 The follow table describes the values assigned to
2268 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg0
</mml:mi></mml:math></inlineequation>,
2269 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg1
</mml:mi></mml:math></inlineequation>,
2271 <inlineequation><mml:math><mml:mi mathvariant=
"italic">Arg2
</mml:mi></mml:math></inlineequation>
2272 based upon the alpha sources and operands:
2276 <informaltable frame=
"topbot">
2277 <tgroup cols=
"3" align=
"left">
2280 <colspec align=
"center"/>
2283 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
2284 <constant>GL_SRCn_ALPHA
</constant>
2286 <entry rowsep=
"1" align=
"left"><emphasis role=
"bold">
2287 <constant>GL_OPERANDn_ALPHA
</constant>
2289 <entry rowsep=
"1" align=
"center"><emphasis role=
"bold">
2296 <entry align=
"left">
2297 <constant>GL_TEXTURE
</constant>
2299 <entry align=
"left">
2300 <constant>GL_SRC_ALPHA
</constant>
2302 <entry align=
"center">
2303 <inlineequation><mml:math>
2304 <!-- eqn: {A sub s}:-->
2305 <mml:mfenced open=
"" close=
"">
2306 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2307 <mml:mi mathvariant=
"italic">s
</mml:mi>
2310 </mml:math></inlineequation>
2314 <entry align=
"left">
2316 <entry align=
"left">
2317 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2319 <entry align=
"center">
2320 <inlineequation><mml:math>
2321 <!-- eqn: 1 - {A sub s}:-->
2325 <mml:mfenced open=
"" close=
"">
2326 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2327 <mml:mi mathvariant=
"italic">s
</mml:mi>
2331 </mml:math></inlineequation>
2335 <entry align=
"left">
2336 <constant>GL_TEXTUREn
</constant>
2338 <entry align=
"left">
2339 <constant>GL_SRC_ALPHA
</constant>
2341 <entry align=
"center">
2342 <inlineequation><mml:math>
2343 <!-- eqn: {A sub s}:-->
2344 <mml:mfenced open=
"" close=
"">
2345 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2346 <mml:mi mathvariant=
"italic">s
</mml:mi>
2349 </mml:math></inlineequation>
2353 <entry align=
"left">
2355 <entry align=
"left">
2356 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2358 <entry align=
"center">
2359 <inlineequation><mml:math>
2360 <!-- eqn: 1 - {A sub s}:-->
2364 <mml:mfenced open=
"" close=
"">
2365 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2366 <mml:mi mathvariant=
"italic">s
</mml:mi>
2370 </mml:math></inlineequation>
2374 <entry align=
"left">
2375 <constant>GL_CONSTANT
</constant>
2377 <entry align=
"left">
2378 <constant>GL_SRC_ALPHA
</constant>
2380 <entry align=
"center">
2381 <inlineequation><mml:math>
2382 <!-- eqn: {A sub c}:-->
2383 <mml:mfenced open=
"" close=
"">
2384 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2385 <mml:mi mathvariant=
"italic">c
</mml:mi>
2388 </mml:math></inlineequation>
2392 <entry align=
"left">
2394 <entry align=
"left">
2395 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2397 <entry align=
"center">
2398 <inlineequation><mml:math>
2399 <!-- eqn: 1 - {A sub c}:-->
2403 <mml:mfenced open=
"" close=
"">
2404 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2405 <mml:mi mathvariant=
"italic">c
</mml:mi>
2409 </mml:math></inlineequation>
2413 <entry align=
"left">
2414 <constant>GL_PRIMARY_COLOR
</constant>
2416 <entry align=
"left">
2417 <constant>GL_SRC_ALPHA
</constant>
2419 <entry align=
"center">
2420 <inlineequation><mml:math>
2421 <!-- eqn: {A sub f}:-->
2422 <mml:mfenced open=
"" close=
"">
2423 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2424 <mml:mi mathvariant=
"italic">f
</mml:mi>
2427 </mml:math></inlineequation>
2431 <entry align=
"left">
2433 <entry align=
"left">
2434 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2436 <entry align=
"center">
2437 <inlineequation><mml:math>
2438 <!-- eqn: 1 - {A sub f}:-->
2442 <mml:mfenced open=
"" close=
"">
2443 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2444 <mml:mi mathvariant=
"italic">f
</mml:mi>
2448 </mml:math></inlineequation>
2452 <entry align=
"left">
2453 <constant>GL_PREVIOUS
</constant>
2455 <entry align=
"left">
2456 <constant>GL_SRC_ALPHA
</constant>
2458 <entry align=
"center">
2459 <inlineequation><mml:math>
2460 <!-- eqn: {A sub p}:-->
2461 <mml:mfenced open=
"" close=
"">
2462 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2463 <mml:mi mathvariant=
"italic">p
</mml:mi>
2466 </mml:math></inlineequation>
2470 <entry align=
"left">
2472 <entry align=
"left">
2473 <constant>GL_ONE_MINUS_SRC_ALPHA
</constant>
2475 <entry align=
"center">
2476 <inlineequation><mml:math>
2477 <!-- eqn: 1 - {A sub p}:-->
2481 <mml:mfenced open=
"" close=
"">
2482 <mml:msub><mml:mi mathvariant=
"italic">A
</mml:mi>
2483 <mml:mi mathvariant=
"italic">p
</mml:mi>
2487 </mml:math></inlineequation>
2494 The RGB and alpha results of the texture function are multipled by the
2495 values of
<constant>GL_RGB_SCALE
</constant> and
<constant>GL_ALPHA_SCALE
</constant>, respectively, and
2496 clamped to the range
2497 <inlineequation><mml:math>
2498 <!-- eqn: [0, 1]:-->
2499 <mml:mfenced open=
"[" close=
"]">
2503 </mml:math></inlineequation>.
2506 If
<parameter>pname
</parameter> is
<constant>GL_TEXTURE_ENV_COLOR
</constant>,
2507 <parameter>params
</parameter> is a pointer to an array that holds an RGBA color consisting of four
2509 Integer color components are interpreted linearly such that the most
2510 positive integer maps to
1.0,
2511 and the most negative integer maps to -
1.0.
2512 The values are clamped to the range [
0,
1] when they are specified.
2513 <inlineequation><mml:math>
2514 <!-- eqn: C sub c:-->
2515 <mml:msub><mml:mi mathvariant=
"italic">C
</mml:mi>
2516 <mml:mi mathvariant=
"italic">c
</mml:mi>
2518 </mml:math></inlineequation>
2519 takes these four values.
2522 If
<parameter>pname
</parameter> is
<constant>GL_TEXTURE_LOD_BIAS
</constant>, the value specified is added to the
2523 texture level-of-detail parameter, that selects which mipmap, or mipmaps
2524 depending upon the selected
<constant>GL_TEXTURE_MIN_FILTER
</constant>, will be sampled.
2527 <constant>GL_TEXTURE_ENV_MODE
</constant> defaults to
<constant>GL_MODULATE
</constant> and
2528 <constant>GL_TEXTURE_ENV_COLOR
</constant> defaults to (
0,
0,
0,
0).
2531 If
<parameter>target
</parameter> is
<constant>GL_POINT_SPRITE
</constant> and
<parameter>pname
</parameter> is
<constant>GL_COORD_REPLACE
</constant>, the boolean value specified
2532 is used to either enable or disable point sprite texture coordinate replacement. The default value is
<constant>GL_FALSE
</constant>.
2535 <refsect1 id=
"notes"><title>Notes
</title>
2537 <constant>GL_REPLACE
</constant> may only be used if the GL version is
1.1 or greater.
2540 <constant>GL_TEXTURE_FILTER_CONTROL
</constant> and
<constant>GL_TEXTURE_LOD_BIAS
</constant> may only be
2541 used if the GL version is
1.4 or greater.
2544 <constant>GL_COMBINE
</constant> mode and its associated constants may only be used if the
2545 GL version is
1.3 or greater.
2548 <constant>GL_TEXTUREn
</constant> may only be used if the GL version is
1.4 or greater.
2551 Internal formats other than
1,
2,
3, or
4 may only be used if the GL
2552 version is
1.1 or greater.
2555 For OpenGL versions
1.3 and greater, or when the
<code>ARB_multitexture
</code> extension is supported,
<function>glTexEnv
</function> controls
2556 the texture environment for the current active texture unit, selected by
2557 <citerefentry><refentrytitle>glActiveTexture
</refentrytitle></citerefentry>.
2560 <constant>GL_POINT_SPRITE
</constant> and
<constant>GL_COORD_REPLACE
</constant> are available
2561 only if the GL version is
2.0 or greater.
2564 <refsect1 id=
"errors"><title>Errors
</title>
2566 <constant>GL_INVALID_ENUM
</constant> is generated when
<parameter>target
</parameter> or
<parameter>pname
</parameter> is not
2567 one of the accepted defined values,
2568 or when
<parameter>params
</parameter> should have a defined constant value
2569 (based on the value of
<parameter>pname
</parameter>)
2573 <constant>GL_INVALID_VALUE
</constant> is generated if the
<parameter>params
</parameter> value for
2574 <constant>GL_RGB_SCALE
</constant> or
<constant>GL_ALPHA_SCALE
</constant> are not one of
1.0,
2.0,
2578 <constant>GL_INVALID_OPERATION
</constant> is generated if
<function>glTexEnv
</function>
2579 is executed between the execution of
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry>
2580 and the corresponding execution of
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry>.
2583 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
2585 <citerefentry><refentrytitle>glGetTexEnv
</refentrytitle></citerefentry>
2588 <refsect1 id=
"seealso"><title>See Also
</title>
2590 <citerefentry><refentrytitle>glActiveTexture
</refentrytitle></citerefentry>,
2591 <citerefentry><refentrytitle>glCopyPixels
</refentrytitle></citerefentry>,
2592 <citerefentry><refentrytitle>glCopyTexImage1D
</refentrytitle></citerefentry>,
2593 <citerefentry><refentrytitle>glCopyTexImage2D
</refentrytitle></citerefentry>,
2594 <citerefentry><refentrytitle>glCopyTexSubImage1D
</refentrytitle></citerefentry>,
2595 <citerefentry><refentrytitle>glCopyTexSubImage2D
</refentrytitle></citerefentry>,
2596 <citerefentry><refentrytitle>glCopyTexSubImage3D
</refentrytitle></citerefentry>,
2597 <citerefentry><refentrytitle>glTexImage1D
</refentrytitle></citerefentry>,
2598 <citerefentry><refentrytitle>glTexImage2D
</refentrytitle></citerefentry>,
2599 <citerefentry><refentrytitle>glTexImage3D
</refentrytitle></citerefentry>,
2600 <citerefentry><refentrytitle>glTexParameter
</refentrytitle></citerefentry>,
2601 <citerefentry><refentrytitle>glTexSubImage1D
</refentrytitle></citerefentry>,
2602 <citerefentry><refentrytitle>glTexSubImage2D
</refentrytitle></citerefentry>,
2603 <citerefentry><refentrytitle>glTexSubImage3D
</refentrytitle></citerefentry>
2606 <refsect1 id=
"Copyright"><title>Copyright
</title>
2608 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
2609 Silicon Graphics, Inc. This document is licensed under the SGI
2610 Free Software B License. For details, see
2611 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.