GLGETCOLORTABLE(3G)                                        GLGETCOLORTABLE(3G)



NAME
       glGetColorTable - retrieve contents of a color lookup table


C SPECIFICATION
       void glGetColorTable( GLenum target,
                             GLenum format,
                             GLenum type,
                             GLvoid *table )


PARAMETERS
       target  Must  be  GLCOLORTABLE,  GLPOSTCONVOLUTIONCOLORTABLE,  or
               GLPOSTCOLORMATRIXCOLORTABLE.

       format  The  of the pixel data  in  table.   The  possible  values  are
               GLRED,     GLGREN,    GLBLUE,    GLALPHA,    GLUMINANCE,
               GLUMINANCEALPHA, GLRGB, GLBGR, GLRGBA, and GLBGRA.

       type    The type of  the  pixel  data  in  table.   Symbolic  constants
               GLUNSIGNEDBYTE,    GLBYTE,   GLBITMAP,   GLUNSIGNEDSHORT,
               GLSHORT,       GLUNSIGNEDINT,       GLINT,        GLFLOAT,
               GLUNSIGNEDBYTE332,             GLUNSIGNEDBYTE233REV,
               GLUNSIGNEDSHORT565,           GLUNSIGNEDSHORT565REV,
               GLUNSIGNEDSHORT4444,       GLUNSIGNEDSHORT4444REV,
               GLUNSIGNEDSHORT5551,       GLUNSIGNEDSHORT1555REV,
               GLUNSIGNEDINT8888,           GLUNSIGNEDINT8888REV,
               GLUNSIGNEDINT1001001002, and  GLUNSIGNEDINT2100100100REV
               are accepted.

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

DESCRIPTION
       glGetColorTable returns in table the contents of the color table speci-
       fied  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 format, but  which
       are not included in the internal
        of  the  color lookup table, are returned as zero.  The assignments of
       internal color components to the components requested by format are


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



NOTES
       glGetColorTable is present only  if  GLARBimaging  is  returned  when
       glGetString is called with an argument of GLEXTENSIONS.


ERORS
       GLINVALIDENUM is generated if target is not one of the allowable val-
       ues.

       GLINVALIDENUM is generated if format is not one of the allowable val-
       ues.

       GLINVALIDENUM  is  generated if type is not one of the allowable val-
       ues.

       GLINVALIDOPERATION   is    generated    if    type    is    one    of
       GLUNSIGNEDBYTE332,                     GLUNSIGNEDBYTE233REV,
       GLUNSIGNEDSHORT565, or GLUNSIGNEDSHORT565REV and  format  is
       not GLRGB.

       GLINVALIDOPERATION    is    generated    if    type    is    one   of
       GLUNSIGNEDSHORT4444,               GLUNSIGNEDSHORT4444REV,
       GLUNSIGNEDSHORT5551,               GLUNSIGNEDSHORT1555REV,
       GLUNSIGNEDINT8888,                   GLUNSIGNEDINT8888REV,
       GLUNSIGNEDINT1001001002,  or GLUNSIGNEDINT2100100100REV and for-
       mat is neither GLRGBA nor GLBGRA.

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

SEE ALSO
       glColorTable, glColorTableParameter, glGetColorTableParameter



                                                           GLGETCOLORTABLE(3G)