xmgetscaledpixmap(3)
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 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.