XmConvertUnits






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



     #include <Xm/Xm.h>
int XmConvertUnits(
Widget widget,
int orientation,
int from_unit_type,
int from_value,
int to_unit_type);



     XmConvertUnits converts the value and returns it as the
return value from the function.  For resources of type,
dimension, or position, you can specify units using the
syntax described in the XmNunitType resource of the
XmPrimitive reference page.

widget    Specifies the widget for which the data is to be
          converted.

orientation
          Specifies whether the converter uses the
          horizontal or vertical screen resolution when
          performing the conversions. The orientation
          parameter can have values of XmHORIZONTAL or
          XmVERTICAL.

from_unit_type
          Specifies the current unit type of the supplied
          value

from_value
          Specifies the value to be converted

to_unit_type
          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
          pixel values. This is the default for the
          resource.

XmMILLIMETERS
          All values provided to the widget are treated as
          millimeter values.

Xm100TH_MILLIMETERS
          All values provided to the widget are treated as









                             ‐2‐


          1/100 of a millimeter.

XmCENTIMETERS
          All values provided to the widget are treated as
          centimeter values.

XmINCHES  All values provided to the widget are treated as
          inch values.

Xm1000TH_INCHES
          All values provided to the widget are treated as
          1/1000 of an inch.

XmPOINTS  All values provided to the widget are treated as
          point values. A point is a unit used in text
          processing applications and is defined as 1/72 of
          an inch.

Xm100TH_POINTS
          All values provided to the widget are treated as
          1/100 of a point.  A point is a unit typically
          used in text processing applications and is
          defined as 1/72 of an inch.

XmFONT_UNITS
          All values provided to the widget are treated as
          normal font units. A font unit has horizontal and
          vertical components.  These are the values of the
          XmScreen resources XmNhorizontalFontUnit and
          XmNverticalFontUnit.

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.



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



     XmPrimitive, XmSetFontUnits(3), and XmScreen(3).