glCopyColorSubTable : PyOpenGL 3.0.1b2 GL Man Pages

respecify a portion of a color table

Deprecation Notice

Note that this function has been marked deprecated in the OpenGL 3.0 specification. You should not be using this function in new code, though it will likely be supported by most implementations via the GL_ARB_compatibility extension. For more information on OpenGL 3.x deprecations, see the deprecations page.

Signature

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

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

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

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