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);
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.
Returns Pixmap or NULL if failed.
Same as for XmGetPixmapByDepth.
XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3)