XmGetScaledPixmap

library call

`XmGetScaledPixmap`

read a pixmap file and scale it according to pixmap and print resolution

    #include <Xm/Xm.h>

    XtEnum XmGetScaledPixmap
    Widget widget
    String image_name
    Pixel foreground
    Pixel background
    int depth
    Double scaling_ratio

## DESCRIPTION

`XmGetScaledPixmap` uses its Widget argument 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 `XmGetScaledPixmap` applies a ratio equals to (printer resolution / default pixmap resolution) before creating the Pixmap on the widget's Screen. Otherwise, the scaling_ratio is used in scaling both dimensions of the image being converted as a Pixmap.

`XmGetScaledPixmap` completes the `XmGetPixmapByDepth` existing API by making use of the XmNdefaultPixmapResolution of 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

&cdeman.XmPrintSetup;, &cdeman.XmPrintShell;, &cdeman.XmRedisplayWidget;