GLCOLORSUBTABLE(3G)                                        GLCOLORSUBTABLE(3G)



NAME
       glColorSubTable - respecify a portion of a color table


C SPECIFICATION
       void glColorSubTable( GLenum target,
                             GLsizei start,
                             GLsizei count,
                             GLenum format,
                             GLenum type,
                             const GLvoid *data )


PARAMETERS
       target  Must be one of GLCOLORTABLE, GLPOSTCONVOLUTIONCOLORTABLE,
               or GLPOSTCOLORMATRIXCOLORTABLE.

       start   The starting index of the portion of  the  color  table  to  be
               replaced.

       count   The number of table entries to replace.

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

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

       data    Pointer  to  a one-dimensional array of pixel data that is pro-
               cessed to replace the specified region of the color table.

DESCRIPTION
       glColorSubTable is used to respecify a contiguous portion  of  a  color
       table  previously defined using glColorTable.  The pixels referenced by
       data replace the portion of the existing table from  indices  start  to
       start  ]  count -1, inclusive.  This region may not include any entries
       outside the range of the color table as it  was  originally  specified.
       It  is not an error to specify a subtexture with width of 0, but such a
       specification has no effect.

NOTES
       glColorSubTable 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.

       GLINVALIDVALUE is generated if start ] count > width.

       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  glColorSubTable  is   executed
       between  the  execution  of  glBegin and the corresponding execution of
       glEnd.

ASOCIATED GETS
       glGetColorTable, glGetColorTableParameter

SEE ALSO
       glColorSubTable,        glColorTableParameter,        glCopyColorTable,
       glCopyColorSubTable, glGetColorTable



                                                           GLCOLORSUBTABLE(3G)