NAME
glGetColorTable
- retrieve contents of a color lookup table
C SPECIFICATION
void ggllGGeettCCoolloorrTTaabbllee(
GLenum _t_a_r_g_e_t,
GLenum _f_o_r_m_a_t,
GLenum _t_y_p_e,
GLvoid _*_t_a_b_l_e )
PARAMETERS
-
_t_a_r_g_e_t
-
Must be GGLL__CCOOLLOORR__TTAABBLLEE,
GGLL__PPOOSSTT__CCOONNVVOOLLUUTTIIOONN__CCOOLLOORR__TTAABBLLEE,
or
GGLL__PPOOSSTT__CCOOLLOORR__MMAATTRRIIXX__CCOOLLOORR__TTAABBLLEE.
-
_f_o_r_m_a_t
-
The of the pixel data in _t_a_b_l_e.
The possible 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 _t_a_b_l_e.
Symbolic constants
GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE,
GGLL__BBYYTTEE,
GGLL__BBIITTMMAAPP,
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
are accepted.
-
_t_a_b_l_e
-
Pointer to a one-dimensional array of pixel data containing the contents
of the color table.
DESCRIPTION
ggllGGeettCCoolloorrTTaabbllee returns in _t_a_b_l_e the contents of the color table specified
by _t_a_r_g_e_t. No pixel transfer operations are performed, but pixel
storage modes that are applicable to
ggllRReeaaddPPiixxeellss are performed.
Color components that are requested in
the specified _f_o_r_m_a_t, but which are not included in the internal
of the color lookup table, are returned as zero. The
assignments of internal color components to the components
requested by _f_o_r_m_a_t are
center;
lb lb
l l.
_
Internal Component Resulting Component
_
red red
green green
blue blue
alpha alpha
luminance red
intensity red
_
NOTES
ggllGGeettCCoolloorrTTaabbllee 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__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 _t_y_p_e is one of
GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE__33__33__22,
GGLL__UUNNSSIIGGNNEEDD__BBYYTTEE__22__33__33__RREEVV,
GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__55__66__55, or
GGLL__UUNNSSIIGGNNEEDD__SSHHOORRTT__55__66__55__RREEVV
and _f_o_r_m_a_t is not GGLL__RRGGBB.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if _t_y_p_e is one of
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, or
GGLL__UUNNSSIIGGNNEEDD__IINNTT__22__1100__1100__1100__RREEVV
and _f_o_r_m_a_t is neither GGLL__RRGGBBAA nor GGLL__BBGGRRAA.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllGGeettCCoolloorrTTaabbllee is executed
between the execution of ggllBBeeggiinn and the corresponding
execution of ggllEEnndd.
SEE ALSO
ggllCCoolloorrTTaabbllee((33GG)),
ggllCCoolloorrTTaabblleePPaarraammeetteerr((33GG)),
ggllGGeettCCoolloorrTTaabblleePPaarraammeetteerr((33GG))