glCopyColorSubTable : PyOpenGL 3.1.4 GL Man Pages

respecify a portion of a color table

Signature

glCopyColorSubTable( GLenum ( target ) , GLsizei ( start ) , GLint ( x ) , GLint ( y ) , GLsizei ( width ) )-> void

glCopyColorSubTable( target , start , x , y , width )

Parameters

Variables	Description
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

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/ .

glCopyColorSubTable