


XcmsConvertColors(3X11)				      XcmsConvertColors(3X11)
X11R5									X11R5



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 for returning 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 specif-
	    ication 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 sin-
  gle 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 exam-
  ple, 3 CIE XYZ, 2 CIE	Luv, ...).  Note that 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 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


