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 spec‐
       ified  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
                       ─────────────────────────────────────────

NOTES
       glGetColorTable  is  present  only  if  GL_ARB_imaging  is returned when
       glGetString is called with an argument of GL_EXTENSIONS.

ERRORS
       GL_INVALID_ENUM is generated if target is not one of the allowable  val‐
       ues.
       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)