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.
SEE ALSO¶
XmPrintSetup(3),
XmPrintShell(3),
XmRedisplayWidget(3)