XmGetScaledPixmap - Man Page

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 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)