fglCopyColorSubTable(3G)

NAME
     fglCopyColorSubTable - respecify a portion of a color table


FORTRAN SPECIFICATION
     SUBROUTINE fglCopyColorSubTable( INTEGER*4 target,
                                      INTEGER*4 start,
                                      INTEGER*4 x,
                                      INTEGER*4 y,
                                      INTEGER*4 width )


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.

     x, y    The window coordinates of the left corner of the row of pixels to
             be copied.

     width   The number of table entries to replace.

DESCRIPTION
     fglCopyColorSubTable is used to respecify a contiguous portion of a color
     table previously defined using fglColorTable.  The pixels copied from the
     framebuffer replace the portion of the existing table from indices start
     to $"start"~+~"x"~-~1$, inclusive.  This region may not include any
     entries outside the range of the color table, as was originally
     specified.  It is not an error to specify a subtexture with width of 0,
     but such a specification has no effect.

NOTES
     fglCopyColorSubTable is present only if GL_ARB_imaging is returned when
     fglGetString is called with an argument of GL_EXTENSIONS.

ERRORS
     GL_INVALID_VALUE is generated if target is not a previously defined color
     table.

     GL_INVALID_VALUE is generated if target is not one of the allowable
     values.

     GL_INVALID_VALUE is generated if $"start"~+~"x"~>~width$.

     GL_INVALID_OPERATION is generated if fglCopyColorSubTable is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.
ASSOCIATED GETS
     fglGetColorTable, fglGetColorTableParameter


SEE ALSO
     fglColorSubTable, fglColorTableParameter, fglCopyColorTable,
     fglCopyColorSubTable, fglGetColorTable