GLCOPYCOLORSUBTABLE(3G)

NAME
glCopyColorSubTable - respecify a portion of a color table

C SPECIFICATION

void glCopyColorSubTable(GLenum target, GLsizei start, GLint x, GLint y, GLsizei 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

glCopyColorSubTable is used to respecify a contiguous portion of a color table previously defined using glColorTable(). 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

glCopyColorSubTable is present only if ARB_imaging is returned when glGetString() 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 glCopyColorSubTable is executed between the execution of glBegin() and the corresponding execution of glEnd().

ASSOCIATED GETS

glGetColorTable(), glGetColorTableParameter()

SEE ALSO

glColorSubTable(), glColorTableParameter(), glCopyColorTable(), glCopyColorSubTable, glGetColorTable()

COPYRIGHT

Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.