Scroll to navigation

GLCOPYCOLORSUBTABLE(3G) 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

Must be one of GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, or GL_POST_COLOR_MATRIX_COLOR_TABLE.
The starting index of the portion of the color table to be replaced.
The window coordinates of the left corner of the row of pixels to be copied.
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 GL_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(3G), glColorTableParameter(3G), glCopyColorTable(3G), glCopyColorSubTable(3G), glGetColorTable(3G)