This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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     GL_COLOR_TABLE,     GL_POST_CONVOLUTION_COLOR_TABLE,     or
               GL_POST_COLOR_MATRIX_COLOR_TABLE.

       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  GL_RED,  GL_GREEN,  GL_BLUE,
               GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, GL_BGR, GL_RGBA, and GL_BGRA.

       type    The  type  of  the  pixel  data in data.  The allowable values are GL_UNSIGNED_BYTE, GL_BYTE,
               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.

       data    Pointer to a one-dimensional array of pixel data that is processed 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  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 values.

       GL_INVALID_VALUE is generated if start + count > width.

       GL_INVALID_ENUM is generated if format is not one of the allowable values.

       GL_INVALID_ENUM is generated if type is not one of the allowable values.

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

ASSOCIATED GETS
       glGetColorTable, glGetColorTableParameter

SEE ALSO
       glColorSubTable(3G), glColorTableParameter(3G), glCopyColorTable(3G), glCopyColorSubTable(3G), glGetColorTable(3G)




                                                                                         GLCOLORSUBTABLE(3G)