XmConvertUnits(3Xm)

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

SYNOPSIS
#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
XmConvertUnits converts the value and returns it as the return value from the function.

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. 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 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-font unit. The value to be used for the font unit is determined in one of two ways. The resource XmNfont can be used in a defaults file or on the command line. The standard command line options of -fn and -font can also be used. The font unit value is taken as the QUAD_WIDTH property of the font. The function XmSetFontUnits allows applications to specify the font unit values.

RETURN VALUE
Returns the converted value.

ERRORS
If a NULL widget, incorrect orientation, or incorrect unit_type is supplied as parameter data, 0 is returned.

RELATED INFORMATION
XmSetFontUnit(3Xm)