XmGetScaledPixmap(3X)

     NAME
          XmGetScaledPixmap - read a pixmap file and scale it
          according to pixmap and print resolution

     SYNOPSIS
          #include <Xm/Xm.h>
          XtEnum XmGetScaledPixmap(
          Widget widget,
          String image_name,
          Pixel foreground,
          Pixel background,
          int depth,
          Double scaling_ratio);

     DESCRIPTION
          XmGetScaledPixmap uses its Widgetargument to look up for a
          Print Shell ancestor to get the pixmap resolution and the
          default printer resolution information to be used if
          scaling_ratio==0.

          If scaling is 0, and a valid PrintShell is present
          XmGetScaledPixmapapplies a ratio equals to (printer
          resolution / default pixmap resolution) before creating the
          Pixmap on the widget's Screen.  Otherwise, the
          scaling_ratiois used in scaling both dimensions of the image
          being converted as a Pixmap.

          XmGetScaledPixmap completes the XmGetPixmapByDepth existing
          API by making use of the XmNdefaultPixmapResolutionof the
          rooting XmPrintShell.  Refer to the XmGetPixmapByDepth
          documentation for details.

          widget    Widget used to determine the default pixmap
                    resolution (of the print shell ancestor).

          image_name
                    See XmGetPixmapByDepth for description.

          foreground
                    See XmGetPixmapByDepth for description.

          background
                    See XmGetPixmapByDepth for description.

          depth     See XmGetPixmapByDepth for description.

          scaling_ratio
                    Indicate the scaling ratio to be applied, or 0.

     RETURN VALUE
          Returns Pixmap or NULL if failed.
     ERRORS/WARNINGS
          Same as for XmGetPixmapByDepth.

     SEE ALSO
          XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3)