upstream-man-pages/man2/xhtml/glPixelTransfer.xml

   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>