upstream-man-pages/man2/xhtml/glColorTable.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>glColorTable</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glColorTable"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glColorTable — define a color lookup table</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">glColorTable</b>(</code></td><td>GLenum  </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLsizei  </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid *  </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
   4                     Must be one of
   5                     <code class="constant">GL_COLOR_TABLE</code>,
   6                     <code class="constant">GL_POST_CONVOLUTION_COLOR_TABLE</code>,
   7                     <code class="constant">GL_POST_COLOR_MATRIX_COLOR_TABLE</code>,
   8                     <code class="constant">GL_PROXY_COLOR_TABLE</code>,
   9                     <code class="constant">GL_PROXY_POST_CONVOLUTION_COLOR_TABLE</code>,
  10                     or
  11                     <code class="constant">GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE</code>.
  12                 </p></dd><dt><span class="term"><em class="parameter"><code>internalformat</code></em></span></dt><dd><p>
  13                     The internal format of the color table.
  14                     The allowable values are
  15                     <code class="constant">GL_ALPHA</code>,
  16                     <code class="constant">GL_ALPHA4</code>,
  17                     <code class="constant">GL_ALPHA8</code>,
  18                     <code class="constant">GL_ALPHA12</code>,
  19                     <code class="constant">GL_ALPHA16</code>,
  20                     <code class="constant">GL_LUMINANCE</code>,
  21                     <code class="constant">GL_LUMINANCE4</code>,
  22                     <code class="constant">GL_LUMINANCE8</code>,
  23                     <code class="constant">GL_LUMINANCE12</code>,
  24                     <code class="constant">GL_LUMINANCE16</code>,
  25                     <code class="constant">GL_LUMINANCE_ALPHA</code>,
  26                     <code class="constant">GL_LUMINANCE4_ALPHA4</code>,
  27                     <code class="constant">GL_LUMINANCE6_ALPHA2</code>,
  28                     <code class="constant">GL_LUMINANCE8_ALPHA8</code>,
  29                     <code class="constant">GL_LUMINANCE12_ALPHA4</code>,
  30                     <code class="constant">GL_LUMINANCE12_ALPHA12</code>,
  31                     <code class="constant">GL_LUMINANCE16_ALPHA16</code>,
  32                     <code class="constant">GL_INTENSITY</code>,
  33                     <code class="constant">GL_INTENSITY4</code>,
  34                     <code class="constant">GL_INTENSITY8</code>,
  35                     <code class="constant">GL_INTENSITY12</code>,
  36                     <code class="constant">GL_INTENSITY16</code>,
  37                     <code class="constant">GL_R3_G3_B2</code>,
  38                     <code class="constant">GL_RGB</code>,
  39                     <code class="constant">GL_RGB4</code>,
  40                     <code class="constant">GL_RGB5</code>,
  41                     <code class="constant">GL_RGB8</code>,
  42                     <code class="constant">GL_RGB10</code>,
  43                     <code class="constant">GL_RGB12</code>,
  44                     <code class="constant">GL_RGB16</code>,
  45                     <code class="constant">GL_RGBA</code>,
  46                     <code class="constant">GL_RGBA2</code>,
  47                     <code class="constant">GL_RGBA4</code>,
  48                     <code class="constant">GL_RGB5_A1</code>,
  49                     <code class="constant">GL_RGBA8</code>,
  50                     <code class="constant">GL_RGB10_A2</code>,
  51                     <code class="constant">GL_RGBA12</code>, and
  52                     <code class="constant">GL_RGBA16</code>.
  53                 </p></dd><dt><span class="term"><em class="parameter"><code>width</code></em></span></dt><dd><p>
  54                     The number of entries in the color lookup table specified by <em class="parameter"><code>data</code></em>.
  55                 </p></dd><dt><span class="term"><em class="parameter"><code>format</code></em></span></dt><dd><p>
  56                     The format of the pixel data in <em class="parameter"><code>data</code></em>.
  57                     The allowable values are
  58                     <code class="constant">GL_RED</code>,
  59                     <code class="constant">GL_GREEN</code>,
  60                     <code class="constant">GL_BLUE</code>,
  61                     <code class="constant">GL_ALPHA</code>,
  62                     <code class="constant">GL_LUMINANCE</code>,
  63                     <code class="constant">GL_LUMINANCE_ALPHA</code>,
  64                     <code class="constant">GL_RGB</code>,
  65                     <code class="constant">GL_BGR</code>,
  66                     <code class="constant">GL_RGBA</code>, and
  67                     <code class="constant">GL_BGRA</code>.
  68                 </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
  69                     The type of the pixel data in <em class="parameter"><code>data</code></em>.
  70                     The allowable values are
  71                     <code class="constant">GL_UNSIGNED_BYTE</code>,
  72                     <code class="constant">GL_BYTE</code>,
  73                     <code class="constant">GL_UNSIGNED_SHORT</code>,
  74                     <code class="constant">GL_SHORT</code>,
  75                     <code class="constant">GL_UNSIGNED_INT</code>,
  76                     <code class="constant">GL_INT</code>,
  77                     <code class="constant">GL_FLOAT</code>,
  78                     <code class="constant">GL_UNSIGNED_BYTE_3_3_2</code>,
  79                     <code class="constant">GL_UNSIGNED_BYTE_2_3_3_REV</code>,
  80                     <code class="constant">GL_UNSIGNED_SHORT_5_6_5</code>,
  81                     <code class="constant">GL_UNSIGNED_SHORT_5_6_5_REV</code>,
  82                     <code class="constant">GL_UNSIGNED_SHORT_4_4_4_4</code>,
  83                     <code class="constant">GL_UNSIGNED_SHORT_4_4_4_4_REV</code>,
  84                     <code class="constant">GL_UNSIGNED_SHORT_5_5_5_1</code>,
  85                     <code class="constant">GL_UNSIGNED_SHORT_1_5_5_5_REV</code>,
  86                     <code class="constant">GL_UNSIGNED_INT_8_8_8_8</code>,
  87                     <code class="constant">GL_UNSIGNED_INT_8_8_8_8_REV</code>,
  88                     <code class="constant">GL_UNSIGNED_INT_10_10_10_2</code>, and
  89                     <code class="constant">GL_UNSIGNED_INT_2_10_10_10_REV</code>.
  90                 </p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
  91                     Pointer to a one-dimensional array of pixel data that is processed to
  92                     build the color table.
  93                 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
  94             <code class="function">glColorTable</code> may be used in two ways:
  95             to test the actual size and color resolution of a lookup table
  96             given a particular set of parameters,
  97             or to load the contents of a color lookup
  98             table.
  99             Use the targets <code class="constant">GL_PROXY_*</code> for the first case
 100             and the other targets for the second case.
 101         </p><p>
 102             If a non-zero named buffer object is bound to the <code class="constant">GL_PIXEL_UNPACK_BUFFER</code> target
 103             (see <a class="citerefentry" href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>) while a color table is
 104             specified, <em class="parameter"><code>data</code></em> is treated as a byte offset into the buffer object's data store.
 105         </p><p>
 106             If <em class="parameter"><code>target</code></em> is <code class="constant">GL_COLOR_TABLE</code>,
 107             <code class="constant">GL_POST_CONVOLUTION_COLOR_TABLE</code>,
 108             or
 109             <code class="constant">GL_POST_COLOR_MATRIX_COLOR_TABLE</code>,
 110             <code class="function">glColorTable</code> builds a color lookup table from an array of pixels.
 111             The pixel array specified by <em class="parameter"><code>width</code></em>, <em class="parameter"><code>format</code></em>, <em class="parameter"><code>type</code></em>, and <em class="parameter"><code>data</code></em>
 112             is extracted from memory and
 113             processed just as if <a class="citerefentry" href="glDrawPixels.xml"><span class="citerefentry"><span class="refentrytitle">glDrawPixels</span></span></a> were called, but processing
 114             stops after the final expansion to RGBA is completed.
 115         </p><p>
 116             The four scale parameters and the four bias parameters that are defined
 117             for the table are then used to scale and bias the R, G, B, and A components
 118             of each pixel.
 119             (Use <code class="function">glColorTableParameter</code> to set these scale and bias
 120             parameters.)
 121         </p><p>
 122             Next, the R, G, B, and A values are clamped to the range
 123             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 124
 125                 <mml:mfenced open="[" close="]">
 126                     <mml:mn>0</mml:mn>
 127                     <mml:mn>1</mml:mn>
 128                 </mml:mfenced>
 129             </mml:math>.
 130             Each pixel is then converted to the internal format specified by
 131             <em class="parameter"><code>internalformat</code></em>.
 132             This conversion simply maps the component values of the pixel (R, G, B,
 133             and A) to the values included in the internal format (red, green, blue,
 134             alpha, luminance, and intensity).  The mapping is as follows:
 135         </p><p>
 136         </p><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
 137                         Internal Format
 138                         </strong></span></th><th align="center"><span class="bold"><strong>
 139                         Red
 140                         </strong></span></th><th align="center"><span class="bold"><strong>
 141                         Green
 142                         </strong></span></th><th align="center"><span class="bold"><strong>
 143                         Blue
 144                         </strong></span></th><th align="center"><span class="bold"><strong>
 145                         Alpha
 146                         </strong></span></th><th align="center"><span class="bold"><strong>
 147                         Luminance
 148                         </strong></span></th><th align="center"><span class="bold"><strong>
 149                         Intensity
 150                         </strong></span></th></tr></thead><tbody><tr><td align="left">
 151                         <code class="constant">GL_ALPHA</code>
 152                         </td><td align="center">
 153                         </td><td align="center">
 154                         </td><td align="center">
 155                         </td><td align="center">
 156                         A
 157                         </td><td align="center">
 158                         </td><td align="center">
 159
 160                         </td></tr><tr><td align="left">
 161                         <code class="constant">GL_LUMINANCE</code>
 162                         </td><td align="center">
 163                         </td><td align="center">
 164                         </td><td align="center">
 165                         </td><td align="center">
 166                         </td><td align="center">
 167                         R
 168                         </td><td align="center">
 169
 170                         </td></tr><tr><td align="left">
 171                         <code class="constant">GL_LUMINANCE_ALPHA</code>
 172                         </td><td align="center">
 173                         </td><td align="center">
 174                         </td><td align="center">
 175                         </td><td align="center">
 176                         A
 177                         </td><td align="center">
 178                         R
 179                         </td><td align="center">
 180
 181                         </td></tr><tr><td align="left">
 182                         <code class="constant">GL_INTENSITY</code>
 183                         </td><td align="center">
 184                         </td><td align="center">
 185                         </td><td align="center">
 186                         </td><td align="center">
 187                         </td><td align="center">
 188                         </td><td align="center">
 189                         R
 190                         </td></tr><tr><td align="left">
 191                         <code class="constant">GL_RGB</code>
 192                         </td><td align="center">
 193                         R
 194                         </td><td align="center">
 195                         G
 196                         </td><td align="center">
 197                         B
 198                         </td><td align="center">
 199                         </td><td align="center">
 200                         </td><td align="center">
 201
 202                         </td></tr><tr><td align="left">
 203                         <code class="constant">GL_RGBA</code>
 204                         </td><td align="center">
 205                         R
 206                         </td><td align="center">
 207                         G
 208                         </td><td align="center">
 209                         B
 210                         </td><td align="center">
 211                         A
 212                         </td><td align="center">
 213                         </td><td align="center">
 214
 215                         </td></tr></tbody></table></div><p>
 216             Finally, the red, green, blue, alpha, luminance, and/or intensity components of
 217             the resulting pixels are stored in the color table.
 218             They form a one-dimensional table with indices in the range
 219             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 220
 221                 <mml:mfenced open="[" close="]">
 222                     <mml:mn>0</mml:mn>
 223                     <mml:mrow>
 224                         <mml:mi mathvariant="italic">width</mml:mi>
 225                         <mml:mo>-</mml:mo>
 226                         <mml:mn>1</mml:mn>
 227                     </mml:mrow>
 228                 </mml:mfenced>
 229             </mml:math>.
 230         </p><p>
 231             If <em class="parameter"><code>target</code></em> is <code class="constant">GL_PROXY_*</code>,
 232             <code class="function">glColorTable</code> recomputes and stores the values of the proxy color table's state
 233             variables
 234             <code class="constant">GL_COLOR_TABLE_FORMAT</code>,
 235             <code class="constant">GL_COLOR_TABLE_WIDTH</code>,
 236             <code class="constant">GL_COLOR_TABLE_RED_SIZE</code>,
 237             <code class="constant">GL_COLOR_TABLE_GREEN_SIZE</code>,
 238             <code class="constant">GL_COLOR_TABLE_BLUE_SIZE</code>,
 239             <code class="constant">GL_COLOR_TABLE_ALPHA_SIZE</code>,
 240             <code class="constant">GL_COLOR_TABLE_LUMINANCE_SIZE</code>, and
 241             <code class="constant">GL_COLOR_TABLE_INTENSITY_SIZE</code>.
 242             There is no effect on the image or state of any actual color table.
 243             If the specified color table is too large to be supported, then all the
 244             proxy state variables listed above are set to zero.
 245             Otherwise, the color table could be supported by <code class="function">glColorTable</code>
 246             using the corresponding non-proxy target,
 247             and the proxy state variables are set as if that target were being defined.
 248         </p><p>
 249             The proxy state variables can be retrieved by calling
 250             <a class="citerefentry" href="glGetColorTableParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetColorTableParameter</span></span></a> with a target of
 251             <code class="constant">GL_PROXY_*</code>.
 252             This allows the application to decide if a particular <code class="function">glColorTable</code>
 253             command would succeed, and to determine what the resulting color table
 254             attributes would be.
 255         </p><p>
 256             If a color table is enabled, and its width is non-zero, then its
 257             contents are used to replace a subset of the components of each RGBA
 258             pixel group, based on the internal format of the table.
 259         </p><p>
 260             Each pixel group has color components (R, G, B, A)
 261             that are in the range
 262             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 263
 264                 <mml:mfenced open="[" close="]">
 265                     <mml:mn>0.0</mml:mn>
 266                     <mml:mn>1.0</mml:mn>
 267                 </mml:mfenced>
 268             </mml:math>.
 269             The color components are rescaled to
 270             the size of the color lookup table to form an index.
 271             Then a subset of the components based on the internal format of the table are
 272             replaced by the table entry selected by that index.
 273             If the color components and contents of the table are represented as follows:
 274         </p><p>
 275         </p><div class="informaltable"><table border="1"><colgroup><col align="center" /><col align="center" /></colgroup><thead><tr><th align="center"><span class="bold"><strong>
 276                         Representation
 277                         </strong></span></th><th align="center"><span class="bold"><strong>
 278                         Meaning
 279                         </strong></span></th></tr></thead><tbody><tr><td align="center">
 280                         <code class="code">r</code>
 281                         </td><td align="left">
 282                         Table index computed from <code class="code">R</code>
 283                         </td></tr><tr><td align="center">
 284                         <code class="code">g</code>
 285                         </td><td align="left">
 286                         Table index computed from <code class="code">G</code>
 287                         </td></tr><tr><td align="center">
 288                         <code class="code">b</code>
 289                         </td><td align="left">
 290                         Table index computed from <code class="code">B</code>
 291                         </td></tr><tr><td align="center">
 292                         <code class="code">a</code>
 293                         </td><td align="left">
 294                         Table index computed from <code class="code">A</code>
 295                         </td></tr><tr><td align="center">
 296                         <code class="code">L[i]</code>
 297                         </td><td align="left">
 298                         Luminance value at table index <code class="code">i</code>
 299                         </td></tr><tr><td align="center">
 300                         <code class="code">I[i]</code>
 301                         </td><td align="left">
 302                         Intensity value at table index <code class="code">i</code>
 303                         </td></tr><tr><td align="center">
 304                         <code class="code">R[i]</code>
 305                         </td><td align="left">
 306                         Red value at table index <code class="code">i</code>
 307                         </td></tr><tr><td align="center">
 308                         <code class="code">G[i]</code>
 309                         </td><td align="left">
 310                         Green value at table index <code class="code">i</code>
 311                         </td></tr><tr><td align="center">
 312                         <code class="code">B[i]</code>
 313                         </td><td align="left">
 314                         Blue value at table index <code class="code">i</code>
 315                         </td></tr><tr><td align="center">
 316                         <code class="code">A[i]</code>
 317                         </td><td align="left">
 318                         Alpha value at table index <code class="code">i</code>
 319                         </td></tr></tbody></table></div><p>
 320             then the result of color table lookup is as follows:
 321         </p><p>
 322         </p><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
 323                         </strong></span></th><th colspan="4" align="center"><span class="bold"><strong>
 324                         Resulting Texture Components
 325                         </strong></span></th></tr><tr><th align="left"><span class="bold"><strong>
 326                         Table Internal Format
 327                         </strong></span></th><th align="center"><span class="bold"><strong>
 328                         R
 329                         </strong></span></th><th align="center"><span class="bold"><strong>
 330                         G
 331                         </strong></span></th><th align="center"><span class="bold"><strong>
 332                         B
 333                         </strong></span></th><th align="center"><span class="bold"><strong>
 334                         A
 335                         </strong></span></th></tr></thead><tbody><tr><td align="left">
 336                         <code class="constant">GL_ALPHA</code>
 337                         </td><td align="center">
 338                         <code class="code">R</code>
 339                         </td><td align="center">
 340                         <code class="code">G</code>
 341                         </td><td align="center">
 342                         <code class="code">B</code>
 343                         </td><td align="center">
 344                         <code class="code">A[a]</code>
 345                         </td></tr><tr><td align="left">
 346                         <code class="constant">GL_LUMINANCE</code>
 347                         </td><td align="center">
 348                         <code class="code">L[r]</code>
 349                         </td><td align="center">
 350                         <code class="code">L[g]</code>
 351                         </td><td align="center">
 352                         <code class="code">L[b]</code>
 353                         </td><td align="center">
 354                         <code class="code">At</code>
 355                         </td></tr><tr><td align="left">
 356                         <code class="constant">GL_LUMINANCE_ALPHA</code>
 357                         </td><td align="center">
 358                         <code class="code">L[r]</code>
 359                         </td><td align="center">
 360                         <code class="code">L[g]</code>
 361                         </td><td align="center">
 362                         <code class="code">L[b]</code>
 363                         </td><td align="center">
 364                         <code class="code">A[a]</code>
 365                         </td></tr><tr><td align="left">
 366                         <code class="constant">GL_INTENSITY</code>
 367                         </td><td align="center">
 368                         <code class="code">I[r]</code>
 369                         </td><td align="center">
 370                         <code class="code">I[g]</code>
 371                         </td><td align="center">
 372                         <code class="code">I[b]</code>
 373                         </td><td align="center">
 374                         <code class="code">I[a]</code>
 375                         </td></tr><tr><td align="left">
 376                         <code class="constant">GL_RGB</code>
 377                         </td><td align="center">
 378                         <code class="code">R[r]</code>
 379                         </td><td align="center">
 380                         <code class="code">G[g]</code>
 381                         </td><td align="center">
 382                         <code class="code">B[b]</code>
 383                         </td><td align="center">
 384                         <code class="code">A</code>
 385                         </td></tr><tr><td align="left">
 386                         <code class="constant">GL_RGBA</code>
 387                         </td><td align="center">
 388                         <code class="code">R[r]</code>
 389                         </td><td align="center">
 390                         <code class="code">G[g]</code>
 391                         </td><td align="center">
 392                         <code class="code">B[b]</code>
 393                         </td><td align="center">
 394                         <code class="code">A[a]</code>
 395                         </td></tr></tbody></table></div><p>
 396             When <code class="constant">GL_COLOR_TABLE</code> is enabled, the colors resulting from
 397             the pixel map operation (if it is enabled) are mapped
 398             by the color lookup table before being passed to the convolution
 399             operation. The colors resulting from the convolution operation
 400             are modified by the post convolution color lookup table when
 401             <code class="constant">GL_POST_CONVOLUTION_COLOR_TABLE</code>
 402             is enabled. These modified colors are then sent to the color matrix operation.
 403             Finally, if <code class="constant">GL_POST_COLOR_MATRIX_COLOR_TABLE</code>
 404             is enabled, the colors resulting from the color matrix operation
 405             are mapped by the post color matrix color lookup table before being
 406             used by the histogram operation.
 407         </p><p>
 408         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
 409             <code class="function">glColorTable</code> is present only if <code class="code">ARB_imaging</code> is returned when <a class="citerefentry" href="glGetString.xml"><span class="citerefentry"><span class="refentrytitle">glGetString</span></span></a>
 410             is called with an argument of <code class="constant">GL_EXTENSIONS</code>.
 411         </p><p>
 412             If <em class="parameter"><code>target</code></em> is set to <code class="constant">GL_COLOR_TABLE</code>,
 413             <code class="constant">GL_POST_CONVOLUTION_COLOR_TABLE</code>,
 414             or <code class="constant">GL_POST_COLOR_MATRIX_COLOR_TABLE</code>,
 415             then <em class="parameter"><code>width</code></em> must be a power of two or a <code class="constant">GL_INVALID_VALUE</code>
 416             error is generated.
 417         </p><p>
 418         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
 419             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not one of the allowable
 420             values.
 421         </p><p>
 422             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>internalformat</code></em> is not one of the
 423             allowable values.
 424         </p><p>
 425             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>format</code></em> is not one of the allowable
 426             values.
 427         </p><p>
 428             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>type</code></em> is not one of the allowable
 429             values.
 430         </p><p>
 431             <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than zero.
 432         </p><p>
 433             <code class="constant">GL_TABLE_TOO_LARGE</code> is generated if the requested color table
 434             is too large to be supported by the implementation, and <em class="parameter"><code>target</code></em> is
 435             not a <code class="constant">GL_PROXY_*</code> target.
 436         </p><p>
 437             <code class="constant">GL_INVALID_OPERATION</code> is generated if a non-zero buffer object name is bound to the
 438             <code class="constant">GL_PIXEL_UNPACK_BUFFER</code> target and the buffer object's data store is currently mapped.
 439         </p><p>
 440             <code class="constant">GL_INVALID_OPERATION</code> is generated if a non-zero buffer object name is bound to the
 441             <code class="constant">GL_PIXEL_UNPACK_BUFFER</code> target and the data would be unpacked from the buffer
 442             object such that the memory reads required would exceed the data store size.
 443         </p><p>
 444             <code class="constant">GL_INVALID_OPERATION</code> is generated if a non-zero buffer object name is bound to the
 445             <code class="constant">GL_PIXEL_UNPACK_BUFFER</code> target and <em class="parameter"><code>data</code></em> is not evenly divisible
 446             into the number of bytes needed to store in memory a datum indicated by <em class="parameter"><code>type</code></em>.
 447         </p><p>
 448             <code class="constant">GL_INVALID_OPERATION</code> is generated if <code class="function">glColorTable</code> is executed
 449             between the execution of <a class="citerefentry" href="glBegin.xml"><span class="citerefentry"><span class="refentrytitle">glBegin</span></span></a> and the corresponding
 450             execution of <a class="citerefentry" href="glEnd.xml"><span class="citerefentry"><span class="refentrytitle">glEnd</span></span></a>.
 451         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
 452             <a class="citerefentry" href="glGetColorTableParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetColorTableParameter</span></span></a>
 453         </p><p>
 454             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_UNPACK_BUFFER_BINDING</code>
 455         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
 456             <a class="citerefentry" href="glColorSubTable.xml"><span class="citerefentry"><span class="refentrytitle">glColorSubTable</span></span></a>,
 457             <code class="function">glColorTableParameter</code>,
 458             <a class="citerefentry" href="glCopyColorTable.xml"><span class="citerefentry"><span class="refentrytitle">glCopyColorTable</span></span></a>,
 459             <a class="citerefentry" href="glCopyColorSubTable.xml"><span class="citerefentry"><span class="refentrytitle">glCopyColorSubTable</span></span></a>,
 460             <a class="citerefentry" href="glGetColorTable.xml"><span class="citerefentry"><span class="refentrytitle">glGetColorTable</span></span></a>
 461         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
 462             Copyright <span class="trademark"></span>© 1991-2006
 463             Silicon Graphics, Inc. This document is licensed under the SGI
 464             Free Software B License. For details, see
 465             <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
 466         </p></div></div></body></html>