XcmsConvertColors(3X11)AIX (XLIB FUNCTIONS)XcmsConvertColors(3X11) NAME XcmsConvertColors - convert CCC color specifications SYNTAX Status XcmsConvertColors(_c_c_c, _c_o_l_o_r_s__i_n__o_u_t, _n_c_o_l_o_r_s, _t_a_r_g_e_t__f_o_r_m_a_t, _c_o_m_p_r_e_s_s_i_o_n__f_l_a_g_s__r_e_t_u_r_n) 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 Specifies an array of Boolean values (or NULL) for returned information that indicates if the color was compressed. For example, if this routine returns _X_c_m_s_S_u_c_c_e_s_s_W_i_t_h_C_o_m_p_r_e_s_s_i_o_n and compression_flags_return[3] is _T_r_u_e, this indi- cates that the fourth color specified in the color specification array was compressed. If you are not interested in knowing which color was compressed when the return value is _X_c_m_s_S_u_c_- _c_e_s_s_W_i_t_h_C_o_m_p_r_e_s_s_i_o_n, then pass a NULL. Otherwise, allocate an array of Boolean values for each ele- ment in the color definition array and pass its address. _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 specifica- tions 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 Rev. Release 5 Page 1 XcmsConvertColors(3X11)AIX (XLIB FUNCTIONS)XcmsConvertColors(3X11) formats (for example, 3 CIE XYZ, 2 CIE Luv, ...). Note that when the array contains both device-independent and device- dependent color specifications, and the target_format argu- ment 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 con- verted to CIE XYZ format 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 Rev. Release 5 Page 2