rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / man4 / xhtml / glBlendEquation.xml
CommitLineData
7faf1d71
AW
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
3<!-- saved from url=(0013)about:internet -->
4<?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" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBlendEquation - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBlendEquation"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBlendEquation — specify the equation used for both the RGB blend equation and the Alpha blend equation</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><p><code class="funcdef">void <b class="fsfunc">glBlendEquation</b>(</code>GLenum <var class="pdparam">mode</var><code>)</code>;</p><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBlendEquationi</b>(</code></td><td>GLuint  </td><td><var class="pdparam">buf</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">mode</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>buf</code></em></span></dt><dd><p>
5 for <code class="function">glBlendEquationi</code>, specifies the index of the draw buffer
6 for which to set the blend equation.
7 </p></dd><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
8 specifies how source and destination colors are combined.
9 It must be <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>,
10 <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>, <code class="constant">GL_MIN</code>, <code class="constant">GL_MAX</code>.
11 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
12 The blend equations determine how a new pixel (the ''source'' color)
13 is combined with a pixel already in the framebuffer (the ''destination''
14 color). This function sets both the RGB blend equation and the alpha
15 blend equation to a single equation. <code class="function">glBlendEquationi</code>
16 specifies the blend equation for a single draw buffer whereas <code class="function">glBlendEquation</code>
17 sets the blend equation for all draw buffers.
18 </p><p>
19 These equations use the source and destination blend factors
20 specified by either <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> or
21 <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
22 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> or <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>
23 for a description of the various blend factors.
24 </p><p>
25 In the equations that follow, source and destination
26 color components are referred to as
27 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
28
29 <mml:mfenced open="(" close=")">
30 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
31 <mml:mi mathvariant="italic">s</mml:mi>
32 </mml:msub>
33 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
34 <mml:mi mathvariant="italic">s</mml:mi>
35 </mml:msub>
36 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
37 <mml:mi mathvariant="italic">s</mml:mi>
38 </mml:msub>
39 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
40 <mml:mi mathvariant="italic">s</mml:mi>
41 </mml:msub>
42 </mml:mfenced>
43 </mml:math>
44 and
45 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
46
47 <mml:mfenced open="(" close=")">
48 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
49 <mml:mi mathvariant="italic">d</mml:mi>
50 </mml:msub>
51 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
52 <mml:mi mathvariant="italic">d</mml:mi>
53 </mml:msub>
54 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
55 <mml:mi mathvariant="italic">d</mml:mi>
56 </mml:msub>
57 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
58 <mml:mi mathvariant="italic">d</mml:mi>
59 </mml:msub>
60 </mml:mfenced>
61 </mml:math>,
62 respectively.
63 The result color is referred to as
64 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
65
66 <mml:mfenced open="(" close=")">
67 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
68 <mml:mi mathvariant="italic">r</mml:mi>
69 </mml:msub>
70 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
71 <mml:mi mathvariant="italic">r</mml:mi>
72 </mml:msub>
73 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
74 <mml:mi mathvariant="italic">r</mml:mi>
75 </mml:msub>
76 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
77 <mml:mi mathvariant="italic">r</mml:mi>
78 </mml:msub>
79 </mml:mfenced>
80 </mml:math>.
81 The source and destination blend factors are denoted
82 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
83
84 <mml:mfenced open="(" close=")">
85 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
86 <mml:mi mathvariant="italic">R</mml:mi>
87 </mml:msub>
88 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
89 <mml:mi mathvariant="italic">G</mml:mi>
90 </mml:msub>
91 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
92 <mml:mi mathvariant="italic">B</mml:mi>
93 </mml:msub>
94 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
95 <mml:mi mathvariant="italic">A</mml:mi>
96 </mml:msub>
97 </mml:mfenced>
98 </mml:math>
99 and
100 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
101
102 <mml:mfenced open="(" close=")">
103 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
104 <mml:mi mathvariant="italic">R</mml:mi>
105 </mml:msub>
106 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
107 <mml:mi mathvariant="italic">G</mml:mi>
108 </mml:msub>
109 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
110 <mml:mi mathvariant="italic">B</mml:mi>
111 </mml:msub>
112 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
113 <mml:mi mathvariant="italic">A</mml:mi>
114 </mml:msub>
115 </mml:mfenced>
116 </mml:math>,
117 respectively.
118 For these equations all color components are understood to have values
119 in the range
120 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
121
122 <mml:mfenced open="[" close="]">
123 <mml:mn>0</mml:mn>
124 <mml:mn>1</mml:mn>
125 </mml:mfenced>
126 </mml:math>.
127
128 </p><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
129 Mode
130 </strong></span></th><th align="left"><span class="bold"><strong>
131 RGB Components
132 </strong></span></th><th align="left"><span class="bold"><strong>
133 Alpha Component
134 </strong></span></th></tr></thead><tbody><tr><td align="left">
135 <code class="constant">GL_FUNC_ADD</code>
136 </td><td align="left">
137 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
138
139 <mml:mrow>
140 <mml:mi mathvariant="italic">Rr</mml:mi>
141 <mml:mo>=</mml:mo>
142 <mml:mrow>
143 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
144 <mml:mi mathvariant="italic">s</mml:mi>
145 </mml:msub>
146 <mml:mo>⁢</mml:mo>
147 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
148 <mml:mi mathvariant="italic">R</mml:mi>
149 </mml:msub>
150 <mml:mo>+</mml:mo>
151 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
152 <mml:mi mathvariant="italic">d</mml:mi>
153 </mml:msub>
154 <mml:mo>⁢</mml:mo>
155 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
156 <mml:mi mathvariant="italic">R</mml:mi>
157 </mml:msub>
158 </mml:mrow>
159 </mml:mrow>
160 </mml:math></div>
161 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
162
163 <mml:mrow>
164 <mml:mi mathvariant="italic">Gr</mml:mi>
165 <mml:mo>=</mml:mo>
166 <mml:mrow>
167 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
168 <mml:mi mathvariant="italic">s</mml:mi>
169 </mml:msub>
170 <mml:mo>⁢</mml:mo>
171 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
172 <mml:mi mathvariant="italic">G</mml:mi>
173 </mml:msub>
174 <mml:mo>+</mml:mo>
175 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
176 <mml:mi mathvariant="italic">d</mml:mi>
177 </mml:msub>
178 <mml:mo>⁢</mml:mo>
179 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
180 <mml:mi mathvariant="italic">G</mml:mi>
181 </mml:msub>
182 </mml:mrow>
183 </mml:mrow>
184 </mml:math></div>
185 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
186
187 <mml:mrow>
188 <mml:mi mathvariant="italic">Br</mml:mi>
189 <mml:mo>=</mml:mo>
190 <mml:mrow>
191 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
192 <mml:mi mathvariant="italic">s</mml:mi>
193 </mml:msub>
194 <mml:mo>⁢</mml:mo>
195 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
196 <mml:mi mathvariant="italic">B</mml:mi>
197 </mml:msub>
198 <mml:mo>+</mml:mo>
199 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
200 <mml:mi mathvariant="italic">d</mml:mi>
201 </mml:msub>
202 <mml:mo>⁢</mml:mo>
203 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
204 <mml:mi mathvariant="italic">B</mml:mi>
205 </mml:msub>
206 </mml:mrow>
207 </mml:mrow>
208 </mml:math></div>
209 </td><td align="left">
210 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
211
212 <mml:mrow>
213 <mml:mi mathvariant="italic">Ar</mml:mi>
214 <mml:mo>=</mml:mo>
215 <mml:mrow>
216 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
217 <mml:mi mathvariant="italic">s</mml:mi>
218 </mml:msub>
219 <mml:mo>⁢</mml:mo>
220 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
221 <mml:mi mathvariant="italic">A</mml:mi>
222 </mml:msub>
223 <mml:mo>+</mml:mo>
224 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
225 <mml:mi mathvariant="italic">d</mml:mi>
226 </mml:msub>
227 <mml:mo>⁢</mml:mo>
228 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
229 <mml:mi mathvariant="italic">A</mml:mi>
230 </mml:msub>
231 </mml:mrow>
232 </mml:mrow>
233 </mml:math></div>
234 </td></tr><tr><td align="left">
235 <code class="constant">GL_FUNC_SUBTRACT</code>
236 </td><td align="left">
237 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
238
239 <mml:mrow>
240 <mml:mi mathvariant="italic">Rr</mml:mi>
241 <mml:mo>=</mml:mo>
242 <mml:mrow>
243 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
244 <mml:mi mathvariant="italic">s</mml:mi>
245 </mml:msub>
246 <mml:mo>⁢</mml:mo>
247 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
248 <mml:mi mathvariant="italic">R</mml:mi>
249 </mml:msub>
250 <mml:mo>-</mml:mo>
251 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
252 <mml:mi mathvariant="italic">d</mml:mi>
253 </mml:msub>
254 <mml:mo>⁢</mml:mo>
255 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
256 <mml:mi mathvariant="italic">R</mml:mi>
257 </mml:msub>
258 </mml:mrow>
259 </mml:mrow>
260 </mml:math></div>
261 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
262
263 <mml:mrow>
264 <mml:mi mathvariant="italic">Gr</mml:mi>
265 <mml:mo>=</mml:mo>
266 <mml:mrow>
267 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
268 <mml:mi mathvariant="italic">s</mml:mi>
269 </mml:msub>
270 <mml:mo>⁢</mml:mo>
271 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
272 <mml:mi mathvariant="italic">G</mml:mi>
273 </mml:msub>
274 <mml:mo>-</mml:mo>
275 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
276 <mml:mi mathvariant="italic">d</mml:mi>
277 </mml:msub>
278 <mml:mo>⁢</mml:mo>
279 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
280 <mml:mi mathvariant="italic">G</mml:mi>
281 </mml:msub>
282 </mml:mrow>
283 </mml:mrow>
284 </mml:math></div>
285 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
286
287 <mml:mrow>
288 <mml:mi mathvariant="italic">Br</mml:mi>
289 <mml:mo>=</mml:mo>
290 <mml:mrow>
291 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
292 <mml:mi mathvariant="italic">s</mml:mi>
293 </mml:msub>
294 <mml:mo>⁢</mml:mo>
295 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
296 <mml:mi mathvariant="italic">B</mml:mi>
297 </mml:msub>
298 <mml:mo>-</mml:mo>
299 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
300 <mml:mi mathvariant="italic">d</mml:mi>
301 </mml:msub>
302 <mml:mo>⁢</mml:mo>
303 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
304 <mml:mi mathvariant="italic">B</mml:mi>
305 </mml:msub>
306 </mml:mrow>
307 </mml:mrow>
308 </mml:math></div>
309 </td><td align="left">
310 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
311
312 <mml:mrow>
313 <mml:mi mathvariant="italic">Ar</mml:mi>
314 <mml:mo>=</mml:mo>
315 <mml:mrow>
316 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
317 <mml:mi mathvariant="italic">s</mml:mi>
318 </mml:msub>
319 <mml:mo>⁢</mml:mo>
320 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
321 <mml:mi mathvariant="italic">A</mml:mi>
322 </mml:msub>
323 <mml:mo>-</mml:mo>
324 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
325 <mml:mi mathvariant="italic">d</mml:mi>
326 </mml:msub>
327 <mml:mo>⁢</mml:mo>
328 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
329 <mml:mi mathvariant="italic">A</mml:mi>
330 </mml:msub>
331 </mml:mrow>
332 </mml:mrow>
333 </mml:math></div>
334 </td></tr><tr><td align="left">
335 <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>
336 </td><td align="left">
337 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
338
339 <mml:mrow>
340 <mml:mi mathvariant="italic">Rr</mml:mi>
341 <mml:mo>=</mml:mo>
342 <mml:mrow>
343 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
344 <mml:mi mathvariant="italic">d</mml:mi>
345 </mml:msub>
346 <mml:mo>⁢</mml:mo>
347 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
348 <mml:mi mathvariant="italic">R</mml:mi>
349 </mml:msub>
350 <mml:mo>-</mml:mo>
351 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
352 <mml:mi mathvariant="italic">s</mml:mi>
353 </mml:msub>
354 <mml:mo>⁢</mml:mo>
355 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
356 <mml:mi mathvariant="italic">R</mml:mi>
357 </mml:msub>
358 </mml:mrow>
359 </mml:mrow>
360 </mml:math></div>
361 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
362
363 <mml:mrow>
364 <mml:mi mathvariant="italic">Gr</mml:mi>
365 <mml:mo>=</mml:mo>
366 <mml:mrow>
367 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
368 <mml:mi mathvariant="italic">d</mml:mi>
369 </mml:msub>
370 <mml:mo>⁢</mml:mo>
371 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
372 <mml:mi mathvariant="italic">G</mml:mi>
373 </mml:msub>
374 <mml:mo>-</mml:mo>
375 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
376 <mml:mi mathvariant="italic">s</mml:mi>
377 </mml:msub>
378 <mml:mo>⁢</mml:mo>
379 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
380 <mml:mi mathvariant="italic">G</mml:mi>
381 </mml:msub>
382 </mml:mrow>
383 </mml:mrow>
384 </mml:math></div>
385 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
386
387 <mml:mrow>
388 <mml:mi mathvariant="italic">Br</mml:mi>
389 <mml:mo>=</mml:mo>
390 <mml:mrow>
391 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
392 <mml:mi mathvariant="italic">d</mml:mi>
393 </mml:msub>
394 <mml:mo>⁢</mml:mo>
395 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
396 <mml:mi mathvariant="italic">B</mml:mi>
397 </mml:msub>
398 <mml:mo>-</mml:mo>
399 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
400 <mml:mi mathvariant="italic">s</mml:mi>
401 </mml:msub>
402 <mml:mo>⁢</mml:mo>
403 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
404 <mml:mi mathvariant="italic">B</mml:mi>
405 </mml:msub>
406 </mml:mrow>
407 </mml:mrow>
408 </mml:math></div>
409 </td><td align="left">
410 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
411
412 <mml:mrow>
413 <mml:mi mathvariant="italic">Ar</mml:mi>
414 <mml:mo>=</mml:mo>
415 <mml:mrow>
416 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
417 <mml:mi mathvariant="italic">d</mml:mi>
418 </mml:msub>
419 <mml:mo>⁢</mml:mo>
420 <mml:msub><mml:mi mathvariant="italic">d</mml:mi>
421 <mml:mi mathvariant="italic">A</mml:mi>
422 </mml:msub>
423 <mml:mo>-</mml:mo>
424 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
425 <mml:mi mathvariant="italic">s</mml:mi>
426 </mml:msub>
427 <mml:mo>⁢</mml:mo>
428 <mml:msub><mml:mi mathvariant="italic">s</mml:mi>
429 <mml:mi mathvariant="italic">A</mml:mi>
430 </mml:msub>
431 </mml:mrow>
432 </mml:mrow>
433 </mml:math></div>
434 </td></tr><tr><td align="left">
435 <code class="constant">GL_MIN</code>
436 </td><td align="left">
437 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
438
439 <mml:mrow>
440 <mml:mi mathvariant="italic">Rr</mml:mi>
441 <mml:mo>=</mml:mo>
442 <mml:mrow>
443 <mml:mi mathvariant="italic">min</mml:mi>
444 <mml:mo>⁡</mml:mo>
445 <mml:mfenced open="(" close=")">
446 <mml:mrow>
447 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
448 <mml:mi mathvariant="italic">s</mml:mi>
449 </mml:msub>
450 </mml:mrow>
451 <mml:mrow>
452 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
453 <mml:mi mathvariant="italic">d</mml:mi>
454 </mml:msub>
455 </mml:mrow>
456 </mml:mfenced>
457 </mml:mrow>
458 </mml:mrow>
459 </mml:math></div>
460 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
461
462 <mml:mrow>
463 <mml:mi mathvariant="italic">Gr</mml:mi>
464 <mml:mo>=</mml:mo>
465 <mml:mrow>
466 <mml:mi mathvariant="italic">min</mml:mi>
467 <mml:mo>⁡</mml:mo>
468 <mml:mfenced open="(" close=")">
469 <mml:mrow>
470 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
471 <mml:mi mathvariant="italic">s</mml:mi>
472 </mml:msub>
473 </mml:mrow>
474 <mml:mrow>
475 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
476 <mml:mi mathvariant="italic">d</mml:mi>
477 </mml:msub>
478 </mml:mrow>
479 </mml:mfenced>
480 </mml:mrow>
481 </mml:mrow>
482 </mml:math></div>
483 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
484
485 <mml:mrow>
486 <mml:mi mathvariant="italic">Br</mml:mi>
487 <mml:mo>=</mml:mo>
488 <mml:mrow>
489 <mml:mi mathvariant="italic">min</mml:mi>
490 <mml:mo>⁡</mml:mo>
491 <mml:mfenced open="(" close=")">
492 <mml:mrow>
493 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
494 <mml:mi mathvariant="italic">s</mml:mi>
495 </mml:msub>
496 </mml:mrow>
497 <mml:mrow>
498 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
499 <mml:mi mathvariant="italic">d</mml:mi>
500 </mml:msub>
501 </mml:mrow>
502 </mml:mfenced>
503 </mml:mrow>
504 </mml:mrow>
505 </mml:math></div>
506 </td><td align="left">
507 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
508
509 <mml:mrow>
510 <mml:mi mathvariant="italic">Ar</mml:mi>
511 <mml:mo>=</mml:mo>
512 <mml:mrow>
513 <mml:mi mathvariant="italic">min</mml:mi>
514 <mml:mo>⁡</mml:mo>
515 <mml:mfenced open="(" close=")">
516 <mml:mrow>
517 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
518 <mml:mi mathvariant="italic">s</mml:mi>
519 </mml:msub>
520 </mml:mrow>
521 <mml:mrow>
522 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
523 <mml:mi mathvariant="italic">d</mml:mi>
524 </mml:msub>
525 </mml:mrow>
526 </mml:mfenced>
527 </mml:mrow>
528 </mml:mrow>
529 </mml:math></div>
530 </td></tr><tr><td align="left">
531 <code class="constant">GL_MAX</code>
532 </td><td align="left">
533 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
534
535 <mml:mrow>
536 <mml:mi mathvariant="italic">Rr</mml:mi>
537 <mml:mo>=</mml:mo>
538 <mml:mrow>
539 <mml:mi mathvariant="italic">max</mml:mi>
540 <mml:mo>⁡</mml:mo>
541 <mml:mfenced open="(" close=")">
542 <mml:mrow>
543 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
544 <mml:mi mathvariant="italic">s</mml:mi>
545 </mml:msub>
546 </mml:mrow>
547 <mml:mrow>
548 <mml:msub><mml:mi mathvariant="italic">R</mml:mi>
549 <mml:mi mathvariant="italic">d</mml:mi>
550 </mml:msub>
551 </mml:mrow>
552 </mml:mfenced>
553 </mml:mrow>
554 </mml:mrow>
555 </mml:math></div>
556 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
557
558 <mml:mrow>
559 <mml:mi mathvariant="italic">Gr</mml:mi>
560 <mml:mo>=</mml:mo>
561 <mml:mrow>
562 <mml:mi mathvariant="italic">max</mml:mi>
563 <mml:mo>⁡</mml:mo>
564 <mml:mfenced open="(" close=")">
565 <mml:mrow>
566 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
567 <mml:mi mathvariant="italic">s</mml:mi>
568 </mml:msub>
569 </mml:mrow>
570 <mml:mrow>
571 <mml:msub><mml:mi mathvariant="italic">G</mml:mi>
572 <mml:mi mathvariant="italic">d</mml:mi>
573 </mml:msub>
574 </mml:mrow>
575 </mml:mfenced>
576 </mml:mrow>
577 </mml:mrow>
578 </mml:math></div>
579 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
580
581 <mml:mrow>
582 <mml:mi mathvariant="italic">Br</mml:mi>
583 <mml:mo>=</mml:mo>
584 <mml:mrow>
585 <mml:mi mathvariant="italic">max</mml:mi>
586 <mml:mo>⁡</mml:mo>
587 <mml:mfenced open="(" close=")">
588 <mml:mrow>
589 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
590 <mml:mi mathvariant="italic">s</mml:mi>
591 </mml:msub>
592 </mml:mrow>
593 <mml:mrow>
594 <mml:msub><mml:mi mathvariant="italic">B</mml:mi>
595 <mml:mi mathvariant="italic">d</mml:mi>
596 </mml:msub>
597 </mml:mrow>
598 </mml:mfenced>
599 </mml:mrow>
600 </mml:mrow>
601 </mml:math></div>
602 </td><td align="left">
603 <div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
604
605 <mml:mrow>
606 <mml:mi mathvariant="italic">Ar</mml:mi>
607 <mml:mo>=</mml:mo>
608 <mml:mrow>
609 <mml:mi mathvariant="italic">max</mml:mi>
610 <mml:mo>⁡</mml:mo>
611 <mml:mfenced open="(" close=")">
612 <mml:mrow>
613 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
614 <mml:mi mathvariant="italic">s</mml:mi>
615 </mml:msub>
616 </mml:mrow>
617 <mml:mrow>
618 <mml:msub><mml:mi mathvariant="italic">A</mml:mi>
619 <mml:mi mathvariant="italic">d</mml:mi>
620 </mml:msub>
621 </mml:mrow>
622 </mml:mfenced>
623 </mml:mrow>
624 </mml:mrow>
625 </mml:math></div>
626 </td></tr></tbody></table></div><p>
627 </p><p>
628 The results of these equations are clamped to the range
629 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
630
631 <mml:mfenced open="[" close="]">
632 <mml:mn>0</mml:mn>
633 <mml:mn>1</mml:mn>
634 </mml:mfenced>
635 </mml:math>.
636 </p><p>
637 The <code class="constant">GL_MIN</code> and <code class="constant">GL_MAX</code> equations are useful for applications
638 that analyze image data (image thresholding against a constant color,
639 for example).
640 The <code class="constant">GL_FUNC_ADD</code> equation is useful
641 for antialiasing and transparency, among other things.
642 </p><p>
643 Initially, both the RGB blend equation and the alpha blend equation are set to <code class="constant">GL_FUNC_ADD</code>.
644 </p><p>
645 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
646 The <code class="constant">GL_MIN</code>, and <code class="constant">GL_MAX</code> equations do not use
647 the source or destination factors, only the source and destination colors.
648 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
649 <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>mode</code></em> is not one of
650 <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>, <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>,
651 <code class="constant">GL_MAX</code>, or <code class="constant">GL_MIN</code>.
652 </p><p>
653 <code class="constant">GL_INVALID_VALUE</code> is generated by <code class="function">glBlendEquationi</code> if <em class="parameter"><code>buf</code></em> is greater
654 than or equal to the value of <code class="constant">GL_MAX_DRAW_BUFFERS</code>.
655 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
656 <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with an argument of <code class="constant">GL_BLEND_EQUATION_RGB</code>
657 </p><p>
658 <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with an argument of <code class="constant">GL_BLEND_EQUATION_ALPHA</code>
659 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
660 <a href="glBlendColor.xml"><span class="citerefentry"><span class="refentrytitle">glBlendColor</span></span></a>,
661 <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a>
662 <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>
663 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
664 Copyright <span class="trademark"></span>© 1991-2006
665 Silicon Graphics, Inc. This document is licensed under the SGI
666 Free Software B License. For details, see
667 <a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
668 </p></div></div></body></html>