XmGetScaledPixmap(library call) XmGetScaledPixmap(library call)
NAME [Toc] [Back]
XmGetScaledPixmap - read a pixmap file and scale it according to
pixmap and print resolution
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XtEnum XmGetScaledPixmap(
Widget widget,
String image_name,
Pixel foreground,
Pixel background,
int depth,
Double scaling_ratio);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
Returns Pixmap or NULL if failed.
- 1 - Formatted: January 24, 2005
XmGetScaledPixmap(library call) XmGetScaledPixmap(library call)
ERRORS/WARNINGS
Same as for XmGetPixmapByDepth.
SEE ALSO [Toc] [Back]
XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3)
- 2 - Formatted: January 24, 2005 [ Back ] |
