


XmConvertUnits(3X)					   XmConvertUnits(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCCoonnvveerrttUUnniittss - A function that converts a value in one unit	type to
  another unit type

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  iinntt XXmmCCoonnvveerrttUUnniittss ((_w_i_d_g_e_t, _o_r_i_e_n_t_a_t_i_o_n, _f_r_o_m__u_n_i_t__t_y_p_e,
	    _f_r_o_m__v_a_l_u_e,	_t_o__u_n_i_t__t_y_p_e))
       WWiiddggeett	 _w_i_d_g_e_t;;
       iinntt	 _o_r_i_e_n_t_a_t_i_o_n;;
       iinntt	 _f_r_o_m__u_n_i_t__t_y_p_e;;
       iinntt	 _f_r_o_m__v_a_l_u_e;;
       iinntt	 _t_o__u_n_i_t__t_y_p_e;;

DESCRIPTION
  XXmmCCoonnvveerrttUUnniittss converts the value and	returns	it as the return value from
  the function.

  _w_i_d_g_e_t      Specifies	the widget for which the data is to be converted

  _o_r_i_e_n_t_a_t_i_o_n Specifies	whether	the converter uses the horizontal or vertical
	      screen resolution	when performing	the conversions.  _o_r_i_e_n_t_a_t_i_o_n
	      can have values of XXmmHHOORRIIZZOONNTTAALL or XXmmVVEERRTTIICCAALL.

  _f_r_o_m__u_n_i_t__t_y_p_e
	      Specifies	the current unit type of the supplied value

  _f_r_o_m__v_a_l_u_e  Specifies	the value to be	converted

  _t_o__u_n_i_t__t_y_p_e
	      Converts the value to the	unit type specified

  The parameters _f_r_o_m__u_n_i_t__t_y_p_e	and _t_o__u_n_i_t__t_y_p_e can have the following
  values:

    oo++  XXmmPPIIXXEELLSS-all values provided to the widget are treated as normal	pixel
       values.	This is	the default for	the resource.

    oo++  XXmm110000TTHH__MMIILLLLIIMMEETTEERRSS-all values provided to the widget are treated as
       1/100 millimeter.

    oo++  XXmm11000000TTHH__IINNCCHHEESS-all values provided to the widget are treated as
       1/1000 inch.

    oo++  XXmm110000TTHH__PPOOIINNTTSS-all values provided to the widget	are treated as 1/100
       point.  A point is a unit typically used	in text	processing applica-
       tions and is defined as 1/72 inch.

    oo++  XXmm110000TTHH__FFOONNTT__UUNNIITTSS-all values provided to the widget are	treated	as
       1/100 of	a font unit.  A	font unit has horizontal and vertical
       components.  These are the values of the	XmScreen resources XXmmNNhhoorr--
       iizzoonnttaallFFoonnttUUnniitt and XXmmNNvveerrttiiccaallFFoonnttUUnniitt.




RETURN VALUE
  Returns the converted	value.	If a NULL widget, incorrect _o_r_i_e_n_t_a_t_i_o_n, or
  incorrect _u_n_i_t__t_y_p_e is supplied as parameter data, 0 is returned.

RELATED	INFORMATION
  XXmmSSeettFFoonnttUUnniittss((33XX)) and XXmmSSccrreeeenn((33XX)).




























































