glColorSubTable

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	 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 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	 val-
       ues.

       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)