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))