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