glCopyColorSubTable(3gl)

1GLCOPYCOLORSUBTABLE(3G)                                GLCOPYCOLORSUBTABLE(3G)
2
3
4

NAME

6       glCopyColorSubTable - respecify a portion of a color table
7
8

C SPECIFICATION

10       void glCopyColorSubTable( GLenum target,
11                                 GLsizei start,
12                                 GLint x,
13                                 GLint y,
14                                 GLsizei width )
15
16

PARAMETERS

18       target  Must be one of GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE,
19               or GL_POST_COLOR_MATRIX_COLOR_TABLE.
20
21       start   The starting index of the portion of  the  color  table  to  be
22               replaced.
23
24       x, y    The  window coordinates of the left corner of the row of pixels
25               to be copied.
26
27       width   The number of table entries to replace.
28

DESCRIPTION

30       glCopyColorSubTable is used to respecify  a  contiguous  portion  of  a
31       color  table  previously defined using glColorTable.  The pixels copied
32       from the framebuffer replace the portion of  the  existing  table  from
33       indices  start  to $"start"~+~"x"~-~1$, inclusive.  This region may not
34       include any entries outside the range of the color table, as was origi‐
35       nally specified.  It is not an error to specify a subtexture with width
36       of 0, but such a specification has no effect.
37

NOTES

39       glCopyColorSubTable is present only if GL_ARB_imaging is returned  when
40       glGetString is called with an argument of GL_EXTENSIONS.
41

ERRORS

43       GL_INVALID_VALUE  is  generated  if  target is not a previously defined
44       color table.
45
46       GL_INVALID_VALUE is generated if target is not  one  of  the  allowable
47       values.
48
49       GL_INVALID_VALUE is generated if $"start"~+~"x"~>~width$.
50
51       GL_INVALID_OPERATION  is  generated  if glCopyColorSubTable is executed
52       between the execution of glBegin and  the  corresponding  execution  of
53       glEnd.
54

ASSOCIATED GETS

56       glGetColorTable, glGetColorTableParameter
57