Commit | Line | Data |
---|---|---|
7faf1d71 AW |
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>glPixelTransfer</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glPixelTransfer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glPixelTransfer — set pixel transfer modes</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">glPixelTransferf</b>(</code></td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">param</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">glPixelTransferi</b>(</code></td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">param</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>pname</code></em></span></dt><dd><p> | |
4 | Specifies the symbolic name of the pixel transfer parameter to be set. | |
5 | Must be one of the following: | |
6 | <code class="constant">GL_MAP_COLOR</code>, | |
7 | <code class="constant">GL_MAP_STENCIL</code>, | |
8 | <code class="constant">GL_INDEX_SHIFT</code>, | |
9 | <code class="constant">GL_INDEX_OFFSET</code>, | |
10 | <code class="constant">GL_RED_SCALE</code>, | |
11 | <code class="constant">GL_RED_BIAS</code>, | |
12 | <code class="constant">GL_GREEN_SCALE</code>, | |
13 | <code class="constant">GL_GREEN_BIAS</code>, | |
14 | <code class="constant">GL_BLUE_SCALE</code>, | |
15 | <code class="constant">GL_BLUE_BIAS</code>, | |
16 | <code class="constant">GL_ALPHA_SCALE</code>, | |
17 | <code class="constant">GL_ALPHA_BIAS</code>, | |
18 | <code class="constant">GL_DEPTH_SCALE</code>, or | |
19 | <code class="constant">GL_DEPTH_BIAS</code>. | |
20 | </p><p> | |
21 | Additionally, if the <code class="code">ARB_imaging</code> extension is supported, the | |
22 | following symbolic names are accepted: | |
23 | <code class="constant">GL_POST_COLOR_MATRIX_RED_SCALE</code>, | |
24 | <code class="constant">GL_POST_COLOR_MATRIX_GREEN_SCALE</code>, | |
25 | <code class="constant">GL_POST_COLOR_MATRIX_BLUE_SCALE</code>, | |
26 | <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_SCALE</code>, | |
27 | <code class="constant">GL_POST_COLOR_MATRIX_RED_BIAS</code>, | |
28 | <code class="constant">GL_POST_COLOR_MATRIX_GREEN_BIAS</code>, | |
29 | <code class="constant">GL_POST_COLOR_MATRIX_BLUE_BIAS</code>, | |
30 | <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_BIAS</code>, | |
31 | <code class="constant">GL_POST_CONVOLUTION_RED_SCALE</code>, | |
32 | <code class="constant">GL_POST_CONVOLUTION_GREEN_SCALE</code>, | |
33 | <code class="constant">GL_POST_CONVOLUTION_BLUE_SCALE</code>, | |
34 | <code class="constant">GL_POST_CONVOLUTION_ALPHA_SCALE</code>, | |
35 | <code class="constant">GL_POST_CONVOLUTION_RED_BIAS</code>, | |
36 | <code class="constant">GL_POST_CONVOLUTION_GREEN_BIAS</code>, | |
37 | <code class="constant">GL_POST_CONVOLUTION_BLUE_BIAS</code>, and | |
38 | <code class="constant">GL_POST_CONVOLUTION_ALPHA_BIAS</code>. | |
39 | </p></dd><dt><span class="term"><em class="parameter"><code>param</code></em></span></dt><dd><p> | |
40 | Specifies the value that <em class="parameter"><code>pname</code></em> is set to. | |
41 | </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p> | |
42 | <code class="function">glPixelTransfer</code> sets pixel transfer modes that affect the operation of subsequent | |
43 | <a class="citerefentry" href="glCopyPixels.xml"><span class="citerefentry"><span class="refentrytitle">glCopyPixels</span></span></a>, | |
44 | <a class="citerefentry" href="glCopyTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage1D</span></span></a>, | |
45 | <a class="citerefentry" href="glCopyTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage2D</span></span></a>, | |
46 | <a class="citerefentry" href="glCopyTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage1D</span></span></a>, | |
47 | <a class="citerefentry" href="glCopyTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage2D</span></span></a>, | |
48 | <a class="citerefentry" href="glCopyTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage3D</span></span></a>, | |
49 | <a class="citerefentry" href="glDrawPixels.xml"><span class="citerefentry"><span class="refentrytitle">glDrawPixels</span></span></a>, | |
50 | <a class="citerefentry" href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>, | |
51 | <a class="citerefentry" href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>, | |
52 | <a class="citerefentry" href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>, | |
53 | <a class="citerefentry" href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>, | |
54 | <a class="citerefentry" href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>, | |
55 | <a class="citerefentry" href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, and | |
56 | <a class="citerefentry" href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a> commands. | |
57 | Additionally, if the <code class="code">ARB_imaging</code> subset is supported, the | |
58 | routines | |
59 | <a class="citerefentry" href="glColorTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorTable</span></span></a>, | |
60 | <a class="citerefentry" href="glColorSubTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorSubTable</span></span></a>, | |
61 | <a class="citerefentry" href="glConvolutionFilter1D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter1D</span></span></a>, | |
62 | <a class="citerefentry" href="glConvolutionFilter2D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter2D</span></span></a>, | |
63 | <a class="citerefentry" href="glHistogram.xml"><span class="citerefentry"><span class="refentrytitle">glHistogram</span></span></a>, | |
64 | <a class="citerefentry" href="glMinmax.xml"><span class="citerefentry"><span class="refentrytitle">glMinmax</span></span></a>, and | |
65 | <a class="citerefentry" href="glSeparableFilter2D.xml"><span class="citerefentry"><span class="refentrytitle">glSeparableFilter2D</span></span></a> are also affected. | |
66 | The algorithms that are specified by pixel transfer modes operate on | |
67 | pixels after they are read from the frame buffer | |
68 | (<a class="citerefentry" href="glCopyPixels.xml"><span class="citerefentry"><span class="refentrytitle">glCopyPixels</span></span></a> | |
69 | <a class="citerefentry" href="glCopyTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage1D</span></span></a>, | |
70 | <a class="citerefentry" href="glCopyTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage2D</span></span></a>, | |
71 | <a class="citerefentry" href="glCopyTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage1D</span></span></a>, | |
72 | <a class="citerefentry" href="glCopyTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage2D</span></span></a>, | |
73 | <a class="citerefentry" href="glCopyTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage3D</span></span></a>, and | |
74 | <a class="citerefentry" href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>), | |
75 | or unpacked from client memory | |
76 | (<a class="citerefentry" href="glDrawPixels.xml"><span class="citerefentry"><span class="refentrytitle">glDrawPixels</span></span></a>, <a class="citerefentry" href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>, <a class="citerefentry" href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>, <a class="citerefentry" href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>, | |
77 | <a class="citerefentry" href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>, <a class="citerefentry" href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, and <a class="citerefentry" href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>). | |
78 | Pixel transfer operations happen in the same order, | |
79 | and in the same manner, | |
80 | regardless of the command that resulted in the pixel operation. | |
81 | Pixel storage modes | |
82 | (see <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>) | |
83 | control the unpacking of pixels being read from client memory | |
84 | and the packing of pixels being written back into client memory. | |
85 | </p><p> | |
86 | Pixel transfer operations handle four fundamental pixel types: | |
87 | <span class="emphasis"><em>color</em></span>, | |
88 | <span class="emphasis"><em>color index</em></span>, | |
89 | <span class="emphasis"><em>depth</em></span>, and | |
90 | <span class="emphasis"><em>stencil</em></span>. | |
91 | <span class="emphasis"><em>Color</em></span> pixels consist of four floating-point values | |
92 | with unspecified mantissa and exponent sizes, | |
93 | scaled such that 0 represents zero intensity | |
94 | and 1 represents full intensity. | |
95 | <span class="emphasis"><em>Color indices</em></span> comprise a single fixed-point value, | |
96 | with unspecified precision to the right of the binary point. | |
97 | <span class="emphasis"><em>Depth</em></span> pixels comprise a single floating-point value, | |
98 | with unspecified mantissa and exponent sizes, | |
99 | scaled such that 0.0 represents the minimum depth buffer value, | |
100 | and 1.0 represents the maximum depth buffer value. | |
101 | Finally, | |
102 | <span class="emphasis"><em>stencil</em></span> pixels comprise a single fixed-point value, | |
103 | with unspecified precision to the right of the binary point. | |
104 | </p><p> | |
105 | The pixel transfer operations performed on the four basic pixel types are | |
106 | as follows: | |
107 | </p><div class="variablelist"><dl><dt><span class="term"><span class="emphasis"><em>Color</em></span></span></dt><dd><p> | |
108 | Each of the four color components is multiplied by a scale factor, | |
109 | then added to a bias factor. | |
110 | That is, | |
111 | the red component is multiplied by <code class="constant">GL_RED_SCALE</code>, | |
112 | then added to <code class="constant">GL_RED_BIAS</code>; | |
113 | the green component is multiplied by <code class="constant">GL_GREEN_SCALE</code>, | |
114 | then added to <code class="constant">GL_GREEN_BIAS</code>; | |
115 | the blue component is multiplied by <code class="constant">GL_BLUE_SCALE</code>, | |
116 | then added to <code class="constant">GL_BLUE_BIAS</code>; and | |
117 | the alpha component is multiplied by <code class="constant">GL_ALPHA_SCALE</code>, | |
118 | then added to <code class="constant">GL_ALPHA_BIAS</code>. | |
119 | After all four color components are scaled and biased, | |
120 | each is clamped to the range | |
121 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
122 | ||
123 | <mml:mfenced open="[" close="]"> | |
124 | <mml:mn>0</mml:mn> | |
125 | <mml:mn>1</mml:mn> | |
126 | </mml:mfenced> | |
127 | </mml:math>. | |
128 | All color, scale, and bias values are specified with <code class="function">glPixelTransfer</code>. | |
129 | </p><p> | |
130 | If <code class="constant">GL_MAP_COLOR</code> is true, | |
131 | each color component is scaled by the size of the corresponding | |
132 | color-to-color map, | |
133 | then replaced by the contents of that map indexed by the scaled component. | |
134 | That is, | |
135 | the red component is scaled by <code class="constant">GL_PIXEL_MAP_R_TO_R_SIZE</code>, | |
136 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_R_TO_R</code> indexed by itself. | |
137 | The green component is scaled by <code class="constant">GL_PIXEL_MAP_G_TO_G_SIZE</code>, | |
138 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_G_TO_G</code> indexed by itself. | |
139 | The blue component is scaled by <code class="constant">GL_PIXEL_MAP_B_TO_B_SIZE</code>, | |
140 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_B_TO_B</code> indexed by itself. | |
141 | And | |
142 | the alpha component is scaled by <code class="constant">GL_PIXEL_MAP_A_TO_A_SIZE</code>, | |
143 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_A_TO_A</code> indexed by itself. | |
144 | All components taken from the maps are then clamped to the range | |
145 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
146 | ||
147 | <mml:mfenced open="[" close="]"> | |
148 | <mml:mn>0</mml:mn> | |
149 | <mml:mn>1</mml:mn> | |
150 | </mml:mfenced> | |
151 | </mml:math>. | |
152 | <code class="constant">GL_MAP_COLOR</code> is specified with <code class="function">glPixelTransfer</code>. | |
153 | The contents of the various maps are specified with <a class="citerefentry" href="glPixelMap.xml"><span class="citerefentry"><span class="refentrytitle">glPixelMap</span></span></a>. | |
154 | </p><p> | |
155 | If the <code class="code">ARB_imaging</code> extension is supported, each of the four | |
156 | color components may be scaled and biased after transformation by the | |
157 | color matrix. | |
158 | That is, | |
159 | the red component is multiplied by <code class="constant">GL_POST_COLOR_MATRIX_RED_SCALE</code>, | |
160 | then added to <code class="constant">GL_POST_COLOR_MATRIX_RED_BIAS</code>; | |
161 | the green component is multiplied by <code class="constant">GL_POST_COLOR_MATRIX_GREEN_SCALE</code>, | |
162 | then added to <code class="constant">GL_POST_COLOR_MATRIX_GREEN_BIAS</code>; | |
163 | the blue component is multiplied by <code class="constant">GL_POST_COLOR_MATRIX_BLUE_SCALE</code>, | |
164 | then added to <code class="constant">GL_POST_COLOR_MATRIX_BLUE_BIAS</code>; and | |
165 | the alpha component is multiplied by <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_SCALE</code>, | |
166 | then added to <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_BIAS</code>. | |
167 | After all four color components are scaled and biased, | |
168 | each is clamped to the range | |
169 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
170 | ||
171 | <mml:mfenced open="[" close="]"> | |
172 | <mml:mn>0</mml:mn> | |
173 | <mml:mn>1</mml:mn> | |
174 | </mml:mfenced> | |
175 | </mml:math>. | |
176 | </p><p> | |
177 | Similarly, if the <code class="code">ARB_imaging</code> extension is supported, each of | |
178 | the four color components may be scaled and biased after processing by | |
179 | the enabled convolution filter. | |
180 | That is, | |
181 | the red component is multiplied by <code class="constant">GL_POST_CONVOLUTION_RED_SCALE</code>, | |
182 | then added to <code class="constant">GL_POST_CONVOLUTION_RED_BIAS</code>; | |
183 | the green component is multiplied by <code class="constant">GL_POST_CONVOLUTION_GREEN_SCALE</code>, | |
184 | then added to <code class="constant">GL_POST_CONVOLUTION_GREEN_BIAS</code>; | |
185 | the blue component is multiplied by <code class="constant">GL_POST_CONVOLUTION_BLUE_SCALE</code>, | |
186 | then added to <code class="constant">GL_POST_CONVOLUTION_BLUE_BIAS</code>; and | |
187 | the alpha component is multiplied by <code class="constant">GL_POST_CONVOLUTION_ALPHA_SCALE</code>, | |
188 | then added to <code class="constant">GL_POST_CONVOLUTION_ALPHA_BIAS</code>. | |
189 | After all four color components are scaled and biased, | |
190 | each is clamped to the range | |
191 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
192 | ||
193 | <mml:mfenced open="[" close="]"> | |
194 | <mml:mn>0</mml:mn> | |
195 | <mml:mn>1</mml:mn> | |
196 | </mml:mfenced> | |
197 | </mml:math>. | |
198 | </p></dd><dt><span class="term"><span class="emphasis"><em>Color index</em></span></span></dt><dd><p> | |
199 | Each color index is shifted left by <code class="constant">GL_INDEX_SHIFT</code> bits; any bits | |
200 | beyond the number of fraction bits carried | |
201 | by the fixed-point index are filled with zeros. | |
202 | If <code class="constant">GL_INDEX_SHIFT</code> is negative, | |
203 | the shift is to the right, | |
204 | again zero filled. | |
205 | Then <code class="constant">GL_INDEX_OFFSET</code> is added to the index. | |
206 | <code class="constant">GL_INDEX_SHIFT</code> and <code class="constant">GL_INDEX_OFFSET</code> are specified with | |
207 | <code class="function">glPixelTransfer</code>. | |
208 | </p><p> | |
209 | From this point, operation diverges depending on the required format of | |
210 | the resulting pixels. | |
211 | If the resulting pixels are to be written to a color index buffer, | |
212 | or if they are being read back to client memory in <code class="constant">GL_COLOR_INDEX</code> format, | |
213 | the pixels continue to be treated as indices. | |
214 | If <code class="constant">GL_MAP_COLOR</code> is true, | |
215 | each index is masked by | |
216 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
217 | ||
218 | <mml:mrow> | |
219 | <mml:msup><mml:mn>2</mml:mn> | |
220 | <mml:mi mathvariant="italic">n</mml:mi> | |
221 | </mml:msup> | |
222 | <mml:mo>-</mml:mo> | |
223 | <mml:mn>1</mml:mn> | |
224 | </mml:mrow> | |
225 | </mml:math>, | |
226 | where | |
227 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math> | |
228 | is <code class="constant">GL_PIXEL_MAP_I_TO_I_SIZE</code>, | |
229 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_I_TO_I</code> indexed by the | |
230 | masked value. | |
231 | <code class="constant">GL_MAP_COLOR</code> is specified with <code class="function">glPixelTransfer</code>. | |
232 | The contents of the index map is specified with <a class="citerefentry" href="glPixelMap.xml"><span class="citerefentry"><span class="refentrytitle">glPixelMap</span></span></a>. | |
233 | </p><p> | |
234 | If the resulting pixels are to be written to an RGBA color buffer, | |
235 | or if they are read back to client memory in a format other than | |
236 | <code class="constant">GL_COLOR_INDEX</code>, | |
237 | the pixels are converted from indices to colors by referencing the | |
238 | four maps | |
239 | <code class="constant">GL_PIXEL_MAP_I_TO_R</code>, | |
240 | <code class="constant">GL_PIXEL_MAP_I_TO_G</code>, | |
241 | <code class="constant">GL_PIXEL_MAP_I_TO_B</code>, and | |
242 | <code class="constant">GL_PIXEL_MAP_I_TO_A</code>. | |
243 | Before being dereferenced, | |
244 | the index is masked by | |
245 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
246 | ||
247 | <mml:mrow> | |
248 | <mml:msup><mml:mn>2</mml:mn> | |
249 | <mml:mi mathvariant="italic">n</mml:mi> | |
250 | </mml:msup> | |
251 | <mml:mo>-</mml:mo> | |
252 | <mml:mn>1</mml:mn> | |
253 | </mml:mrow> | |
254 | </mml:math>, | |
255 | where | |
256 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math> | |
257 | is | |
258 | <code class="constant">GL_PIXEL_MAP_I_TO_R_SIZE</code> for the red map, | |
259 | <code class="constant">GL_PIXEL_MAP_I_TO_G_SIZE</code> for the green map, | |
260 | <code class="constant">GL_PIXEL_MAP_I_TO_B_SIZE</code> for the blue map, and | |
261 | <code class="constant">GL_PIXEL_MAP_I_TO_A_SIZE</code> for the alpha map. | |
262 | All components taken from the maps are then clamped to the range | |
263 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
264 | ||
265 | <mml:mfenced open="[" close="]"> | |
266 | <mml:mn>0</mml:mn> | |
267 | <mml:mn>1</mml:mn> | |
268 | </mml:mfenced> | |
269 | </mml:math>. | |
270 | The contents of the four maps is specified with <a class="citerefentry" href="glPixelMap.xml"><span class="citerefentry"><span class="refentrytitle">glPixelMap</span></span></a>. | |
271 | </p></dd><dt><span class="term"><span class="emphasis"><em>Depth</em></span></span></dt><dd><p> | |
272 | Each depth value is multiplied by <code class="constant">GL_DEPTH_SCALE</code>, | |
273 | added to <code class="constant">GL_DEPTH_BIAS</code>, | |
274 | then clamped to the range | |
275 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
276 | ||
277 | <mml:mfenced open="[" close="]"> | |
278 | <mml:mn>0</mml:mn> | |
279 | <mml:mn>1</mml:mn> | |
280 | </mml:mfenced> | |
281 | </mml:math>. | |
282 | </p></dd><dt><span class="term"><span class="emphasis"><em>Stencil</em></span></span></dt><dd><p> | |
283 | Each index is shifted <code class="constant">GL_INDEX_SHIFT</code> bits just as a color index is, | |
284 | then added to <code class="constant">GL_INDEX_OFFSET</code>. | |
285 | If <code class="constant">GL_MAP_STENCIL</code> is true, | |
286 | each index is masked by | |
287 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
288 | ||
289 | <mml:mrow> | |
290 | <mml:msup><mml:mn>2</mml:mn> | |
291 | <mml:mi mathvariant="italic">n</mml:mi> | |
292 | </mml:msup> | |
293 | <mml:mo>-</mml:mo> | |
294 | <mml:mn>1</mml:mn> | |
295 | </mml:mrow> | |
296 | </mml:math>, | |
297 | where | |
298 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math> | |
299 | is <code class="constant">GL_PIXEL_MAP_S_TO_S_SIZE</code>, | |
300 | then replaced by the contents of <code class="constant">GL_PIXEL_MAP_S_TO_S</code> indexed by the | |
301 | masked value. | |
302 | </p></dd></dl></div><p> | |
303 | The following table gives the type, | |
304 | initial value, | |
305 | and range of valid values for each of the pixel transfer parameters | |
306 | that are set with <code class="function">glPixelTransfer</code>. | |
307 | </p><p> | |
308 | </p><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong> | |
309 | <em class="parameter"><code>pname</code></em> | |
310 | </strong></span></th><th align="center"><span class="bold"><strong> | |
311 | Type | |
312 | </strong></span></th><th align="center"><span class="bold"><strong> | |
313 | Initial Value | |
314 | </strong></span></th><th align="center"><span class="bold"><strong> | |
315 | Valid Range | |
316 | </strong></span></th></tr></thead><tbody><tr><td align="left"> | |
317 | <code class="constant">GL_MAP_COLOR</code> | |
318 | </td><td align="center"> | |
319 | boolean | |
320 | </td><td align="center"> | |
321 | false | |
322 | </td><td align="center"> | |
323 | true/false | |
324 | </td></tr><tr><td align="left"> | |
325 | <code class="constant">GL_MAP_STENCIL</code> | |
326 | </td><td align="center"> | |
327 | boolean | |
328 | </td><td align="center"> | |
329 | false | |
330 | </td><td align="center"> | |
331 | true/false | |
332 | </td></tr><tr><td align="left"> | |
333 | <code class="constant">GL_INDEX_SHIFT</code> | |
334 | </td><td align="center"> | |
335 | integer | |
336 | </td><td align="center"> | |
337 | 0 | |
338 | </td><td align="center"> | |
339 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
340 | ||
341 | <mml:mfenced open="(" close=")"> | |
342 | <mml:mrow> | |
343 | <mml:mo>-</mml:mo> | |
344 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
345 | </mml:mrow> | |
346 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
347 | </mml:mfenced> | |
348 | </mml:math> | |
349 | </td></tr><tr><td align="left"> | |
350 | <code class="constant">GL_INDEX_OFFSET</code> | |
351 | </td><td align="center"> | |
352 | integer | |
353 | </td><td align="center"> | |
354 | 0 | |
355 | </td><td align="center"> | |
356 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
357 | ||
358 | <mml:mfenced open="(" close=")"> | |
359 | <mml:mrow> | |
360 | <mml:mo>-</mml:mo> | |
361 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
362 | </mml:mrow> | |
363 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
364 | </mml:mfenced> | |
365 | </mml:math> | |
366 | </td></tr><tr><td align="left"> | |
367 | <code class="constant">GL_RED_SCALE</code> | |
368 | </td><td align="center"> | |
369 | float | |
370 | </td><td align="center"> | |
371 | 1 | |
372 | </td><td align="center"> | |
373 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
374 | ||
375 | <mml:mfenced open="(" close=")"> | |
376 | <mml:mrow> | |
377 | <mml:mo>-</mml:mo> | |
378 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
379 | </mml:mrow> | |
380 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
381 | </mml:mfenced> | |
382 | </mml:math> | |
383 | </td></tr><tr><td align="left"> | |
384 | <code class="constant">GL_GREEN_SCALE</code> | |
385 | </td><td align="center"> | |
386 | float | |
387 | </td><td align="center"> | |
388 | 1 | |
389 | </td><td align="center"> | |
390 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
391 | ||
392 | <mml:mfenced open="(" close=")"> | |
393 | <mml:mrow> | |
394 | <mml:mo>-</mml:mo> | |
395 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
396 | </mml:mrow> | |
397 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
398 | </mml:mfenced> | |
399 | </mml:math> | |
400 | </td></tr><tr><td align="left"> | |
401 | <code class="constant">GL_BLUE_SCALE</code> | |
402 | </td><td align="center"> | |
403 | float | |
404 | </td><td align="center"> | |
405 | 1 | |
406 | </td><td align="center"> | |
407 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
408 | ||
409 | <mml:mfenced open="(" close=")"> | |
410 | <mml:mrow> | |
411 | <mml:mo>-</mml:mo> | |
412 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
413 | </mml:mrow> | |
414 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
415 | </mml:mfenced> | |
416 | </mml:math> | |
417 | </td></tr><tr><td align="left"> | |
418 | <code class="constant">GL_ALPHA_SCALE</code> | |
419 | </td><td align="center"> | |
420 | float | |
421 | </td><td align="center"> | |
422 | 1 | |
423 | </td><td align="center"> | |
424 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
425 | ||
426 | <mml:mfenced open="(" close=")"> | |
427 | <mml:mrow> | |
428 | <mml:mo>-</mml:mo> | |
429 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
430 | </mml:mrow> | |
431 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
432 | </mml:mfenced> | |
433 | </mml:math> | |
434 | </td></tr><tr><td align="left"> | |
435 | <code class="constant">GL_DEPTH_SCALE</code> | |
436 | </td><td align="center"> | |
437 | float | |
438 | </td><td align="center"> | |
439 | 1 | |
440 | </td><td align="center"> | |
441 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
442 | ||
443 | <mml:mfenced open="(" close=")"> | |
444 | <mml:mrow> | |
445 | <mml:mo>-</mml:mo> | |
446 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
447 | </mml:mrow> | |
448 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
449 | </mml:mfenced> | |
450 | </mml:math> | |
451 | </td></tr><tr><td align="left"> | |
452 | <code class="constant">GL_RED_BIAS</code> | |
453 | </td><td align="center"> | |
454 | float | |
455 | </td><td align="center"> | |
456 | 0 | |
457 | </td><td align="center"> | |
458 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
459 | ||
460 | <mml:mfenced open="(" close=")"> | |
461 | <mml:mrow> | |
462 | <mml:mo>-</mml:mo> | |
463 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
464 | </mml:mrow> | |
465 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
466 | </mml:mfenced> | |
467 | </mml:math> | |
468 | </td></tr><tr><td align="left"> | |
469 | <code class="constant">GL_GREEN_BIAS</code> | |
470 | </td><td align="center"> | |
471 | float | |
472 | </td><td align="center"> | |
473 | 0 | |
474 | </td><td align="center"> | |
475 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
476 | ||
477 | <mml:mfenced open="(" close=")"> | |
478 | <mml:mrow> | |
479 | <mml:mo>-</mml:mo> | |
480 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
481 | </mml:mrow> | |
482 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
483 | </mml:mfenced> | |
484 | </mml:math> | |
485 | </td></tr><tr><td align="left"> | |
486 | <code class="constant">GL_BLUE_BIAS</code> | |
487 | </td><td align="center"> | |
488 | float | |
489 | </td><td align="center"> | |
490 | 0 | |
491 | </td><td align="center"> | |
492 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
493 | ||
494 | <mml:mfenced open="(" close=")"> | |
495 | <mml:mrow> | |
496 | <mml:mo>-</mml:mo> | |
497 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
498 | </mml:mrow> | |
499 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
500 | </mml:mfenced> | |
501 | </mml:math> | |
502 | </td></tr><tr><td align="left"> | |
503 | <code class="constant">GL_ALPHA_BIAS</code> | |
504 | </td><td align="center"> | |
505 | float | |
506 | </td><td align="center"> | |
507 | 0 | |
508 | </td><td align="center"> | |
509 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
510 | ||
511 | <mml:mfenced open="(" close=")"> | |
512 | <mml:mrow> | |
513 | <mml:mo>-</mml:mo> | |
514 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
515 | </mml:mrow> | |
516 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
517 | </mml:mfenced> | |
518 | </mml:math> | |
519 | </td></tr><tr><td align="left"> | |
520 | <code class="constant">GL_DEPTH_BIAS</code> | |
521 | </td><td align="center"> | |
522 | float | |
523 | </td><td align="center"> | |
524 | 0 | |
525 | </td><td align="center"> | |
526 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
527 | ||
528 | <mml:mfenced open="(" close=")"> | |
529 | <mml:mrow> | |
530 | <mml:mo>-</mml:mo> | |
531 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
532 | </mml:mrow> | |
533 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
534 | </mml:mfenced> | |
535 | </mml:math> | |
536 | </td></tr><tr><td align="left"> | |
537 | <code class="constant">GL_POST_COLOR_MATRIX_RED_SCALE</code> | |
538 | </td><td align="center"> | |
539 | float | |
540 | </td><td align="center"> | |
541 | 1 | |
542 | </td><td align="center"> | |
543 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
544 | ||
545 | <mml:mfenced open="(" close=")"> | |
546 | <mml:mrow> | |
547 | <mml:mo>-</mml:mo> | |
548 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
549 | </mml:mrow> | |
550 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
551 | </mml:mfenced> | |
552 | </mml:math> | |
553 | </td></tr><tr><td align="left"> | |
554 | <code class="constant">GL_POST_COLOR_MATRIX_GREEN_SCALE</code> | |
555 | </td><td align="center"> | |
556 | float | |
557 | </td><td align="center"> | |
558 | 1 | |
559 | </td><td align="center"> | |
560 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
561 | ||
562 | <mml:mfenced open="(" close=")"> | |
563 | <mml:mrow> | |
564 | <mml:mo>-</mml:mo> | |
565 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
566 | </mml:mrow> | |
567 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
568 | </mml:mfenced> | |
569 | </mml:math> | |
570 | </td></tr><tr><td align="left"> | |
571 | <code class="constant">GL_POST_COLOR_MATRIX_BLUE_SCALE</code> | |
572 | </td><td align="center"> | |
573 | float | |
574 | </td><td align="center"> | |
575 | 1 | |
576 | </td><td align="center"> | |
577 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
578 | ||
579 | <mml:mfenced open="(" close=")"> | |
580 | <mml:mrow> | |
581 | <mml:mo>-</mml:mo> | |
582 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
583 | </mml:mrow> | |
584 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
585 | </mml:mfenced> | |
586 | </mml:math> | |
587 | </td></tr><tr><td align="left"> | |
588 | <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_SCALE</code> | |
589 | </td><td align="center"> | |
590 | float | |
591 | </td><td align="center"> | |
592 | 1 | |
593 | </td><td align="center"> | |
594 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
595 | ||
596 | <mml:mfenced open="(" close=")"> | |
597 | <mml:mrow> | |
598 | <mml:mo>-</mml:mo> | |
599 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
600 | </mml:mrow> | |
601 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
602 | </mml:mfenced> | |
603 | </mml:math> | |
604 | </td></tr><tr><td align="left"> | |
605 | <code class="constant">GL_POST_COLOR_MATRIX_RED_BIAS</code> | |
606 | </td><td align="center"> | |
607 | float | |
608 | </td><td align="center"> | |
609 | 0 | |
610 | </td><td align="center"> | |
611 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
612 | ||
613 | <mml:mfenced open="(" close=")"> | |
614 | <mml:mrow> | |
615 | <mml:mo>-</mml:mo> | |
616 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
617 | </mml:mrow> | |
618 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
619 | </mml:mfenced> | |
620 | </mml:math> | |
621 | </td></tr><tr><td align="left"> | |
622 | <code class="constant">GL_POST_COLOR_MATRIX_GREEN_BIAS</code> | |
623 | </td><td align="center"> | |
624 | float | |
625 | </td><td align="center"> | |
626 | 0 | |
627 | </td><td align="center"> | |
628 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
629 | ||
630 | <mml:mfenced open="(" close=")"> | |
631 | <mml:mrow> | |
632 | <mml:mo>-</mml:mo> | |
633 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
634 | </mml:mrow> | |
635 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
636 | </mml:mfenced> | |
637 | </mml:math> | |
638 | </td></tr><tr><td align="left"> | |
639 | <code class="constant">GL_POST_COLOR_MATRIX_BLUE_BIAS</code> | |
640 | </td><td align="center"> | |
641 | float | |
642 | </td><td align="center"> | |
643 | 0 | |
644 | </td><td align="center"> | |
645 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
646 | ||
647 | <mml:mfenced open="(" close=")"> | |
648 | <mml:mrow> | |
649 | <mml:mo>-</mml:mo> | |
650 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
651 | </mml:mrow> | |
652 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
653 | </mml:mfenced> | |
654 | </mml:math> | |
655 | </td></tr><tr><td align="left"> | |
656 | <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_BIAS</code> | |
657 | </td><td align="center"> | |
658 | float | |
659 | </td><td align="center"> | |
660 | 0 | |
661 | </td><td align="center"> | |
662 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
663 | ||
664 | <mml:mfenced open="(" close=")"> | |
665 | <mml:mrow> | |
666 | <mml:mo>-</mml:mo> | |
667 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
668 | </mml:mrow> | |
669 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
670 | </mml:mfenced> | |
671 | </mml:math> | |
672 | </td></tr><tr><td align="left"> | |
673 | <code class="constant">GL_POST_CONVOLUTION_RED_SCALE</code> | |
674 | </td><td align="center"> | |
675 | float | |
676 | </td><td align="center"> | |
677 | 1 | |
678 | </td><td align="center"> | |
679 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
680 | ||
681 | <mml:mfenced open="(" close=")"> | |
682 | <mml:mrow> | |
683 | <mml:mo>-</mml:mo> | |
684 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
685 | </mml:mrow> | |
686 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
687 | </mml:mfenced> | |
688 | </mml:math> | |
689 | </td></tr><tr><td align="left"> | |
690 | <code class="constant">GL_POST_CONVOLUTION_GREEN_SCALE</code> | |
691 | </td><td align="center"> | |
692 | float | |
693 | </td><td align="center"> | |
694 | 1 | |
695 | </td><td align="center"> | |
696 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
697 | ||
698 | <mml:mfenced open="(" close=")"> | |
699 | <mml:mrow> | |
700 | <mml:mo>-</mml:mo> | |
701 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
702 | </mml:mrow> | |
703 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
704 | </mml:mfenced> | |
705 | </mml:math> | |
706 | </td></tr><tr><td align="left"> | |
707 | <code class="constant">GL_POST_CONVOLUTION_BLUE_SCALE</code> | |
708 | </td><td align="center"> | |
709 | float | |
710 | </td><td align="center"> | |
711 | 1 | |
712 | </td><td align="center"> | |
713 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
714 | ||
715 | <mml:mfenced open="(" close=")"> | |
716 | <mml:mrow> | |
717 | <mml:mo>-</mml:mo> | |
718 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
719 | </mml:mrow> | |
720 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
721 | </mml:mfenced> | |
722 | </mml:math> | |
723 | </td></tr><tr><td align="left"> | |
724 | <code class="constant">GL_POST_CONVOLUTION_ALPHA_SCALE</code> | |
725 | </td><td align="center"> | |
726 | float | |
727 | </td><td align="center"> | |
728 | 1 | |
729 | </td><td align="center"> | |
730 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
731 | ||
732 | <mml:mfenced open="(" close=")"> | |
733 | <mml:mrow> | |
734 | <mml:mo>-</mml:mo> | |
735 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
736 | </mml:mrow> | |
737 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
738 | </mml:mfenced> | |
739 | </mml:math> | |
740 | </td></tr><tr><td align="left"> | |
741 | <code class="constant">GL_POST_CONVOLUTION_RED_BIAS</code> | |
742 | </td><td align="center"> | |
743 | float | |
744 | </td><td align="center"> | |
745 | 0 | |
746 | </td><td align="center"> | |
747 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
748 | ||
749 | <mml:mfenced open="(" close=")"> | |
750 | <mml:mrow> | |
751 | <mml:mo>-</mml:mo> | |
752 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
753 | </mml:mrow> | |
754 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
755 | </mml:mfenced> | |
756 | </mml:math> | |
757 | </td></tr><tr><td align="left"> | |
758 | <code class="constant">GL_POST_CONVOLUTION_GREEN_BIAS</code> | |
759 | </td><td align="center"> | |
760 | float | |
761 | </td><td align="center"> | |
762 | 0 | |
763 | </td><td align="center"> | |
764 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
765 | ||
766 | <mml:mfenced open="(" close=")"> | |
767 | <mml:mrow> | |
768 | <mml:mo>-</mml:mo> | |
769 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
770 | </mml:mrow> | |
771 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
772 | </mml:mfenced> | |
773 | </mml:math> | |
774 | </td></tr><tr><td align="left"> | |
775 | <code class="constant">GL_POST_CONVOLUTION_BLUE_BIAS</code> | |
776 | </td><td align="center"> | |
777 | float | |
778 | </td><td align="center"> | |
779 | 0 | |
780 | </td><td align="center"> | |
781 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
782 | ||
783 | <mml:mfenced open="(" close=")"> | |
784 | <mml:mrow> | |
785 | <mml:mo>-</mml:mo> | |
786 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
787 | </mml:mrow> | |
788 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
789 | </mml:mfenced> | |
790 | </mml:math> | |
791 | </td></tr><tr><td align="left"> | |
792 | <code class="constant">GL_POST_CONVOLUTION_ALPHA_BIAS</code> | |
793 | </td><td align="center"> | |
794 | float | |
795 | </td><td align="center"> | |
796 | 0 | |
797 | </td><td align="center"> | |
798 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
799 | ||
800 | <mml:mfenced open="(" close=")"> | |
801 | <mml:mrow> | |
802 | <mml:mo>-</mml:mo> | |
803 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
804 | </mml:mrow> | |
805 | <mml:infinity definitionURL="" encoding=""></mml:infinity> | |
806 | </mml:mfenced> | |
807 | </mml:math> | |
808 | </td></tr></tbody></table></div><p> | |
809 | <code class="function">glPixelTransferf</code> can be used to set any pixel transfer parameter. | |
810 | If the parameter type is boolean, | |
811 | 0 implies false and any other value implies true. | |
812 | If <em class="parameter"><code>pname</code></em> is an integer parameter, | |
813 | <em class="parameter"><code>param</code></em> is rounded to the nearest integer. | |
814 | </p><p> | |
815 | Likewise, | |
816 | <code class="function">glPixelTransferi</code> can be used to set any of the | |
817 | pixel transfer parameters. | |
818 | Boolean parameters are set to false if <em class="parameter"><code>param</code></em> is 0 and to true otherwise. | |
819 | <em class="parameter"><code>param</code></em> is converted to floating point before being assigned to real-valued parameters. | |
820 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p> | |
821 | If a | |
822 | <a class="citerefentry" href="glColorTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorTable</span></span></a>, | |
823 | <a class="citerefentry" href="glColorSubTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorSubTable</span></span></a>, | |
824 | <a class="citerefentry" href="glConvolutionFilter1D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter1D</span></span></a>, | |
825 | <a class="citerefentry" href="glConvolutionFilter2D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter2D</span></span></a>, | |
826 | <a class="citerefentry" href="glCopyPixels.xml"><span class="citerefentry"><span class="refentrytitle">glCopyPixels</span></span></a>, | |
827 | <a class="citerefentry" href="glCopyTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage1D</span></span></a>, | |
828 | <a class="citerefentry" href="glCopyTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage2D</span></span></a>, | |
829 | <a class="citerefentry" href="glCopyTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage1D</span></span></a>, | |
830 | <a class="citerefentry" href="glCopyTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage2D</span></span></a>, | |
831 | <a class="citerefentry" href="glCopyTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage3D</span></span></a>, | |
832 | <a class="citerefentry" href="glDrawPixels.xml"><span class="citerefentry"><span class="refentrytitle">glDrawPixels</span></span></a>, | |
833 | <a class="citerefentry" href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>, | |
834 | <a class="citerefentry" href="glSeparableFilter2D.xml"><span class="citerefentry"><span class="refentrytitle">glSeparableFilter2D</span></span></a>, | |
835 | <a class="citerefentry" href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>, | |
836 | <a class="citerefentry" href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>, | |
837 | <a class="citerefentry" href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>, | |
838 | <a class="citerefentry" href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>, | |
839 | <a class="citerefentry" href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, or | |
840 | <a class="citerefentry" href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a> | |
841 | command is placed in a display list | |
842 | (see <a class="citerefentry" href="glNewList.xml"><span class="citerefentry"><span class="refentrytitle">glNewList</span></span></a> and <a class="citerefentry" href="glCallList.xml"><span class="citerefentry"><span class="refentrytitle">glCallList</span></span></a>), | |
843 | the pixel transfer mode settings in effect when the display list is | |
844 | <span class="emphasis"><em>executed</em></span> | |
845 | are the ones that are used. | |
846 | They may be different from the settings when the command was compiled | |
847 | into the display list. | |
848 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p> | |
849 | <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not an accepted value. | |
850 | </p><p> | |
851 | <code class="constant">GL_INVALID_OPERATION</code> is generated if <code class="function">glPixelTransfer</code> | |
852 | is executed between the execution of <a class="citerefentry" href="glBegin.xml"><span class="citerefentry"><span class="refentrytitle">glBegin</span></span></a> | |
853 | and the corresponding execution of <a class="citerefentry" href="glEnd.xml"><span class="citerefentry"><span class="refentrytitle">glEnd</span></span></a>. | |
854 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p> | |
855 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_MAP_COLOR</code> | |
856 | </p><p> | |
857 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_MAP_STENCIL</code> | |
858 | </p><p> | |
859 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_INDEX_SHIFT</code> | |
860 | </p><p> | |
861 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_INDEX_OFFSET</code> | |
862 | </p><p> | |
863 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_RED_SCALE</code> | |
864 | </p><p> | |
865 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_RED_BIAS</code> | |
866 | </p><p> | |
867 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_GREEN_SCALE</code> | |
868 | </p><p> | |
869 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_GREEN_BIAS</code> | |
870 | </p><p> | |
871 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLUE_SCALE</code> | |
872 | </p><p> | |
873 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLUE_BIAS</code> | |
874 | </p><p> | |
875 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ALPHA_SCALE</code> | |
876 | </p><p> | |
877 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ALPHA_BIAS</code> | |
878 | </p><p> | |
879 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_DEPTH_SCALE</code> | |
880 | </p><p> | |
881 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_DEPTH_BIAS</code> | |
882 | </p><p> | |
883 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_RED_SCALE</code> | |
884 | </p><p> | |
885 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_RED_BIAS</code> | |
886 | </p><p> | |
887 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_GREEN_SCALE</code> | |
888 | </p><p> | |
889 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_GREEN_BIAS</code> | |
890 | </p><p> | |
891 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_BLUE_SCALE</code> | |
892 | </p><p> | |
893 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_BLUE_BIAS</code> | |
894 | </p><p> | |
895 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_SCALE</code> | |
896 | </p><p> | |
897 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_COLOR_MATRIX_ALPHA_BIAS</code> | |
898 | </p><p> | |
899 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_RED_SCALE</code> | |
900 | </p><p> | |
901 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_RED_BIAS</code> | |
902 | </p><p> | |
903 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_GREEN_SCALE</code> | |
904 | </p><p> | |
905 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_GREEN_BIAS</code> | |
906 | </p><p> | |
907 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_BLUE_SCALE</code> | |
908 | </p><p> | |
909 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_BLUE_BIAS</code> | |
910 | </p><p> | |
911 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_ALPHA_SCALE</code> | |
912 | </p><p> | |
913 | <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POST_CONVOLUTION_ALPHA_BIAS</code> | |
914 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p> | |
915 | <a class="citerefentry" href="glCallList.xml"><span class="citerefentry"><span class="refentrytitle">glCallList</span></span></a>, | |
916 | <a class="citerefentry" href="glColorTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorTable</span></span></a>, | |
917 | <a class="citerefentry" href="glColorSubTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorSubTable</span></span></a>, | |
918 | <a class="citerefentry" href="glConvolutionFilter1D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter1D</span></span></a>, | |
919 | <a class="citerefentry" href="glConvolutionFilter2D.xml"><span class="citerefentry"><span class="refentrytitle">glConvolutionFilter2D</span></span></a>, | |
920 | <a class="citerefentry" href="glCopyPixels.xml"><span class="citerefentry"><span class="refentrytitle">glCopyPixels</span></span></a>, | |
921 | <a class="citerefentry" href="glCopyTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage1D</span></span></a>, | |
922 | <a class="citerefentry" href="glCopyTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage2D</span></span></a>, | |
923 | <a class="citerefentry" href="glCopyTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage1D</span></span></a>, | |
924 | <a class="citerefentry" href="glCopyTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage2D</span></span></a>, | |
925 | <a class="citerefentry" href="glCopyTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexSubImage3D</span></span></a>, | |
926 | <a class="citerefentry" href="glDrawPixels.xml"><span class="citerefentry"><span class="refentrytitle">glDrawPixels</span></span></a>, | |
927 | <a class="citerefentry" href="glNewList.xml"><span class="citerefentry"><span class="refentrytitle">glNewList</span></span></a>, | |
928 | <a class="citerefentry" href="glPixelMap.xml"><span class="citerefentry"><span class="refentrytitle">glPixelMap</span></span></a>, | |
929 | <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>, | |
930 | <a class="citerefentry" href="glPixelZoom.xml"><span class="citerefentry"><span class="refentrytitle">glPixelZoom</span></span></a>, | |
931 | <a class="citerefentry" href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>, | |
932 | <a class="citerefentry" href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>, | |
933 | <a class="citerefentry" href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>, | |
934 | <a class="citerefentry" href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>, | |
935 | <a class="citerefentry" href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>, | |
936 | <a class="citerefentry" href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, | |
937 | <a class="citerefentry" href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a> | |
938 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p> | |
939 | Copyright <span class="trademark"></span>© 1991-2006 | |
940 | Silicon Graphics, Inc. This document is licensed under the SGI | |
941 | Free Software B License. For details, see | |
942 | <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>. | |
943 | </p></div></div></body></html> |