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