XmeToVerticalPixels(3X)



     XmeToVerticalPixels(3X)   UNIX System V   XmeToVerticalPixels(3X)



     NAME
          XmeToVerticalPixels - Converts from real-world dimensions to
          pixels

     SYNOPSIS
          #include <Xm/XmP.h>
          XmImportOperator XmeToVerticalPixels(
          Widget widget,
          int offset,
          XtArgVal *value);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          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 XmNunitTyperesource.

          For example, suppose that widget has an XmNunitType resource
          value of Xm1000THINCHES. 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.

     RETURN
          Returns one of the following XmImportOperator values:

          XmSYNTHETICNONE
                    The caller of the XmImportProc is not responsible
                    for copying the converted value into the resource
                    specified by offset.

          XmSYNTHETICLOAD



     Page 1                                          (printed 1/22/99)



     XmeToVerticalPixels(3X)   UNIX System V   XmeToVerticalPixels(3X)



                    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 XmSYTHETICLOAD, Motif synthetic resource mechanism
          will take care of copying (and casting) value into the
          resource symbolized by offset.

     RELATED
          XmeFromHorizontalPixels(3), XmeFromVerticalPixels(3), and
          XmeToHorizontalPixels(3).










































     Page 2                                          (printed 1/22/99)

Museum