NAME
glCopyColorSubTable
- respecify a portion of a color table
C SPECIFICATION
void ggllCCooppyyCCoolloorrSSuubbTTaabbllee(
GLenum _t_a_r_g_e_t,
GLsizei _s_t_a_r_t,
GLint _x,
GLint _y,
GLsizei _w_i_d_t_h )
PARAMETERS
-
_t_a_r_g_e_t
-
Must be one of
GGLL__CCOOLLOORR__TTAABBLLEE,
GGLL__PPOOSSTT__CCOONNVVOOLLUUTTIIOONN__CCOOLLOORR__TTAABBLLEE, or
GGLL__PPOOSSTT__CCOOLLOORR__MMAATTRRIIXX__CCOOLLOORR__TTAABBLLEE.
-
_s_t_a_r_t
-
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.
-
_w_i_d_t_h
-
The number of table entries to replace.
DESCRIPTION
ggllCCooppyyCCoolloorrSSuubbTTaabbllee is used to respecify a contiguous portion of a color table previously
defined using ggllCCoolloorrTTaabbllee. The pixels copied from the framebuffer
replace the portion of the existing table from indices _s_t_a_r_t 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
ggllCCooppyyCCoolloorrSSuubbTTaabbllee is present only if GGLL__AARRBB__iimmaaggiinngg is returned when ggllGGeettSSttrriinngg
is called with an argument of GGLL__EEXXTTEENNSSIIOONNSS.
ERRORS
GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if _t_a_r_g_e_t is not a previously defined
color table.
GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if _t_a_r_g_e_t is not one of the allowable
values.
GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if $"start"~+~"x"~>~width$.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllCCooppyyCCoolloorrSSuubbTTaabbllee is executed
between the execution of ggllBBeeggiinn and the corresponding
execution of ggllEEnndd.
ASSOCIATED GETS
ggllGGeettCCoolloorrTTaabbllee,
ggllGGeettCCoolloorrTTaabblleePPaarraammeetteerr
SEE ALSO
ggllCCoolloorrSSuubbTTaabbllee((33GG)),
ggllCCoolloorrTTaabblleePPaarraammeetteerr((33GG)),
ggllCCooppyyCCoolloorrTTaabbllee((33GG)),
ggllCCooppyyCCoolloorrSSuubbTTaabbllee((33GG)),
ggllGGeettCCoolloorrTTaabbllee((33GG))