fglCopyColorSubTable(3G) OpenGL Reference 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.
Page 1
fglCopyColorSubTable(3G) OpenGL Reference fglCopyColorSubTable(3G)ASSOCIATED GETS
fglGetColorTable, fglGetColorTableParameter
SEE ALSO
fglColorSubTable, fglColorTableParameter, fglCopyColorTable,
fglCopyColorSubTable, fglGetColorTable
Page 2
