C SPECIFICATION

       void GLAPIENTRY glGetColorTable( GLenum target,
                                        GLenum forma )

PARAMETERS

       target  Must  be  GL_COLOR_TABLE,  GL_POST_CONVOLUTION_COLOR_TABLE,  or
               GL_POST_COLOR_MATRIX_COLOR_TABLE.

       forma   The format of the pixel data in _param4.  The  possible  values
               are   GL_RED,   GL_GREEN,   GL_BLUE,   GL_ALPHA,  GL_LUMINANCE,
               GL_LUMINANCE_ALPHA, GL_RGB, GL_BGR, GL_RGBA, and GL_BGRA.

       _param3 The type of the pixel  data  in  _param4.   Symbolic  constants
               GL_UNSIGNED_BYTE,    GL_BYTE,   GL_BITMAP,   GL_UNSIGNED_SHORT,
               GL_SHORT,       GL_UNSIGNED_INT,       GL_INT,        GL_FLOAT,
               GL_UNSIGNED_BYTE_3_3_2,             GL_UNSIGNED_BYTE_2_3_3_REV,
               GL_UNSIGNED_SHORT_5_6_5,           GL_UNSIGNED_SHORT_5_6_5_REV,
               GL_UNSIGNED_SHORT_4_4_4_4,       GL_UNSIGNED_SHORT_4_4_4_4_REV,
               GL_UNSIGNED_SHORT_5_5_5_1,       GL_UNSIGNED_SHORT_1_5_5_5_REV,
               GL_UNSIGNED_INT_8_8_8_8,           GL_UNSIGNED_INT_8_8_8_8_REV,
               GL_UNSIGNED_INT_10_10_10_2, and  GL_UNSIGNED_INT_2_10_10_10_REV
               are accepted.

       _param4 Pointer to a one-dimensional array of pixel data containing the
               contents of the color table.

DESCRIPTION

       glGetColorTable returns in _param4 the  contents  of  the  color  table
       specified  by  target.  No pixel transfer operations are performed, but
       pixel storage modes that are applicable to glReadPixels are  performed.

       Color  components  that are requested in the specified forma, but which
       are not included in the internal format of the color lookup table,  are
       returned  as zero.  The assignments of internal color components to the
       components requested by forma are


                      -----------------------------------------
                      Internal Component   Resulting Component
                      -----------------------------------------
                      red                  red
                      green                green
                      blue                 blue
                      alpha                alpha
                      luminance            red
                      intensity            red
                      -----------------------------------------




       GL_INVALID_OPERATION   is   generated   if   _param3    is    one    of
       GL_UNSIGNED_BYTE_3_3_2,                     GL_UNSIGNED_BYTE_2_3_3_REV,
       GL_UNSIGNED_SHORT_5_6_5, or GL_UNSIGNED_SHORT_5_6_5_REV  and  forma  is
       not GL_RGB.

       GL_INVALID_OPERATION    is    generated    if   _param3   is   one   of
       GL_UNSIGNED_SHORT_4_4_4_4,               GL_UNSIGNED_SHORT_4_4_4_4_REV,
       GL_UNSIGNED_SHORT_5_5_5_1,               GL_UNSIGNED_SHORT_1_5_5_5_REV,
       GL_UNSIGNED_INT_8_8_8_8,                   GL_UNSIGNED_INT_8_8_8_8_REV,
       GL_UNSIGNED_INT_10_10_10_2, or GL_UNSIGNED_INT_2_10_10_10_REV and forma
       is neither GL_RGBA nor GL_BGRA.

       GL_INVALID_OPERATION  is  generated  if  glGetColorTable  is   executed
       between  the  execution  of  glBegin and the corresponding execution of
       glEnd.

SEE ALSO

       glColorTable, glColorTableParameter, glGetColorTableParameter



                                                           GLGETCOLORTABLE(3G)