NAME

glColorSubTable - respecify a portion of a color table

C SPECIFICATION

void ggllCCoolloorrSSuubbTTaabbllee( GLenum _t_a_r_g_e_t,
                      GLsizei _s_t_a_r_t,
                      GLsizei _c_o_u_n_t,
                      GLenum _f_o_r_m_a_t,
                      GLenum _t_y_p_e,
                      const GLvoid _*_d_a_t_a )

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.
_c_o_u_n_t
The number of table entries to replace.
_f_o_r_m_a_t
The of the pixel data in _d_a_t_a. The allowable values are GGLL__RREEDD, GGLL__GGRREEEENN, GGLL__BBLLUUEE, GGLL__AALLPPHHAA, GGLL__LLUUMMIINNAANNCCEE, GGLL__LLUUMMIINNAANNCCEE__AALLPPHHAA, GGLL__RRGGBB, GGLL__BBGGRR, GGLL__RRGGBBAA, and GGLL__BBGGRRAA.
_t_y_p_e
The type of the pixel data in _d_a_t_a. The allowable values are GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE, GGLL__BBYYTTEE, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT, GGLL__SSHHOORRTT, GGLL__UUNNSSIIGGNNEEDD__IINNTT, GGLL__IINNTT, GGLL__FFLLOOAATT, GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE__33__33__22, GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE__22__33__33__RREEVV, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__55__66__55, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__55__66__55__RREEVV, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__44__44__44__44, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__44__44__44__44__RREEVV, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__55__55__55__11, GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__11__55__55__55__RREEVV, GGLL__UUNNSSIIGGNNEEDD__IINNTT__88__88__88__88, GGLL__UUNNSSIIGGNNEEDD__IINNTT__88__88__88__88__RREEVV, GGLL__UUNNSSIIGGNNEEDD__IINNTT__1100__1100__1100__22, and GGLL__UUNNSSIIGGNNEEDD__IINNTT__22__1100__1100__1100__RREEVV.
_d_a_t_a
Pointer to a one-dimensional array of pixel data that is processed to replace the specified region of the color table.

DESCRIPTION

ggllCCoolloorrSSuubbTTaabbllee is used to respecify a contiguous portion of a color table previously defined using ggllCCoolloorrTTaabbllee. The pixels referenced by _d_a_t_a replace the portion of the existing table from indices _s_t_a_r_t to $"start"~+~"count"~-~1$, inclusive. This region may not include any entries outside the range of the color table as it was originally specified. It is not an error to specify a subtexture with width of 0, but such a specification has no effect.

NOTES

ggllCCoolloorrSSuubbTTaabbllee is present only if GGLL__AARRBB__iimmaaggiinngg is returned when ggllGGeettSSttrriinngg is called with an argument of GGLL__EEXXTTEENNSSIIOONNSS.

ERRORS

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _t_a_r_g_e_t is not one of the allowable values.

GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if $"start"~+~"count"~>~width$.

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _f_o_r_m_a_t is not one of the allowable values.

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _t_y_p_e is not one of the allowable values.

GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllCCoolloorrSSuubbTTaabbllee 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))