XmGetScaledPixmap

Motif 2.1 Programmer's Reference

XmGetScaledPixmap

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

Format

#include <Xm/Xm.h>
XtEnum XmGetScaledPixmapWidget
widgetString image_namePixel
foregroundPixel backgroundint
depthDouble 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

XmPrintSetup (3), XmPrintShell (3), XmRedisplayWidget (3)