XmeToVerticalPixels — Converts from real-world dimensions to pixels
#include <Xm/XmP.h>
XmImportOperator XmeToVerticalPixels(widget, offset, value);XmeToVerticalPixels converts a vertical distance from a real-world dimensional unit (such as thousandths of an inch) to pixels. This conversion is based on the vertical resolution of the screen. The choice of real-world dimensional unit is stored in the XmNunitType resource.
For example, suppose that widget has an XmNunitType resource value of Xm1000TH_INCHES. If the input value were 2000 (meaning 2000/1000 inches or 2 inches), then XmeToVerticalPixels determines how many vertical pixels fall within 2 inches. Because different screens have different resolutions, the returned value might be 160 pixels on one screen and 200 pixels on another.
Typically, your widget will call this function in a synthetic resource record.
XmeToVerticalPixels is an XmImportProc.
| widget | Specifies the widget. | |
| offset | Specifies the offset (in bytes) of a synthetic resource field in the widget record. | |
| value | Specifies a value in the XmNunitType real-world dimensional units used by widget and returns a value in pixels. |
Returns one of the following XmImportOperator values:
| XmSYNTHETIC_NONE | The caller of the XmImportProc is not responsible for copying the converted value into the resource specified by offset. | |
| XmSYNTHETIC_LOAD | The caller of the XmImportProc is responsible for copying the converted value into the resource specified by offset. |
Motif's synthetic resource mechanism is typically the caller of XmeToVerticalPixels. Therefore, if XmeToVerticalPixels returns XmSYTHETIC_LOAD, Motif synthetic resource mechanism will take care of copying (and casting) value into the resource symbolized by offset.