XmeToHorizontalPixels(3X)



     XmeToHorizontalPixels(3X) UNIX System V XmeToHorizontalPixels(3X)



     NAME
          XmeToHorizontalPixels - Converts from real-world dimensions
          to pixels

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeToHorizontalPixels converts a horizontal distance from a
          real-world dimensional unit (such as thousandths of an inch)
          to pixels.  This conversion is based on the horizontal
          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
          XmeToHorizontalPixels determines how many horizontal 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.

          XmeToHorizontalPixels is an XmImportProc.

          Typically, your widget will call this function from a
          synthetic resource record.

          widget    Specifies the widget containing the resource named
                    by offset.

          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.




     Page 1                                          (printed 1/22/99)



     XmeToHorizontalPixels(3X) UNIX System V XmeToHorizontalPixels(3X)



          XmSYNTHETICLOAD
                    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 XmeToHorizontalPixels.  Therefore, if
          XmeToHorizontalPixels 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
          XmeToVerticalPixels(3).









































     Page 2                                          (printed 1/22/99)

Museum