NAME

XcmsConvertColors - convert CCC color specifications

SYNTAX

Status XcmsConvertColors(XcmsCCC _c_c_c, XcmsColor _c_o_l_o_r_s___i_n___o_u_t[], unsigned int _n_c_o_l_o_r_s, XcmsColorFormat _t_a_r_g_e_t___f_o_r_m_a_t, Bool _c_o_m_p_r_e_s_s_i_o_n___f_l_a_g_s___r_e_t_u_r_n[]);

ARGUMENTS

_c_c_c Specifies the CCC.
If Conversion is between device-independent color spaces only (for example, TekHVC to CIELuv), the CCC is necessary only to specify the Client White Point.
_c_o_l_o_r_s___i_n___o_u_t Specifies an array of color specifications.
Pixel members are ignored and remain unchanged upon return.
_c_o_m_p_r_e_s_s_i_o_n___f_l_a_g_s___r_e_t_u_r_n Returns an array of Boolean values indicating compression status.
If a non-NULL pointer is supplied, each element of the array is set to _T_r_u_e if the corresponding color was compressed and _F_a_l_s_e otherwise. Pass NULL if the compression status is not useful.
_n_c_o_l_o_r_s Specifies the number of
_X_c_m_s_C_o_l_o_r structures in the color-specification array.
_t_a_r_g_e_t___f_o_r_m_a_t Specifies the target color specification format.

DESCRIPTION

The _X_c_m_s_C_o_n_v_e_r_t_C_o_l_o_r_s function converts the color specifications in the specified array of _X_c_m_s_C_o_l_o_r structures from their current format to a single target format, using the specified CCC. When the return value is _X_c_m_s_F_a_i_l_u_r_e, the contents of the color specification array are left unchanged.

The array may contain a mixture of color specification formats (for example, 3 CIE XYZ, 2 CIE Luv, and so on). When the array contains both device-independent and device-dependent color specifications and the target_format argument specifies a device-dependent format (for example, _X_c_m_s_R_G_B_i_F_o_r_m_a_t, _X_c_m_s_R_G_B_F_o_r_m_a_t), all specifications are converted to CIE XYZ format and then to the target device-dependent format.

SEE ALSO

DisplayOfCCC(3X11), XcmsCCCOfColormap(3X11), XcmsCreateCCC(3X11), XcmsDefaultCCC(3X11), XcmsSetWhitePoint(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e