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