NAME    [Toc]    [Back]

       XmConvertUnits  -  A function that converts a value in one
       unit type to another unit type

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

       int XmConvertUnits (widget,  orientation,  from_unit_type,
       from_value, to_unit_type)
               Widget widget;
               int orientation;
               int from_unit_type;
               int from_value;
               int to_unit_type;

DESCRIPTION    [Toc]    [Back]

       XmConvertUnits  converts  the  value and returns it as the
       return value from the function.  Specifies the widget  for
       which  the  data  is to be converted Specifies whether the
       converter uses the horizontal or vertical  screen  resolution
  when  performing  the  conversions.  orientation can
       have values of XmHORIZONTAL or XmVERTICAL.  Specifies  the
       current  unit  type  of  the  supplied value Specifies the
       value to be converted Converts the value to the unit  type
       specified

       The  parameters  from_unit_type  and to_unit_type can have
       the following values: XmPIXELS--all values provided to the
       widget  are  treated  as normal pixel values.  This is the
       default for the resource.  Xm100TH_MILLIMETERS--all values
       provided  to  the  widget are treated as 1/100 millimeter.
       Xm1000TH_INCHES--all values provided  to  the  widget  are
       treated  as  1/1000 inch.  Xm100TH_POINTS--all values provided
 to the widget are treated as 1/100 point. A point is
       a  unit typically used in text processing applications and
       is defined as 1/72 inch.   Xm100TH_FONT_UNITS--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 XmNhorizontalFontUnit
 and XmNverticalFontUnit.

RETURN VALUE    [Toc]    [Back]

       Returns the converted value. If a NULL  widget,  incorrect
       orientation, or incorrect unit_type is supplied as parameter
 data, 0 is returned.

SEE ALSO    [Toc]    [Back]

       XmSetFontUnits(3X), XmScreen(3X)



                                               XmConvertUnits(3X)