XmGetScaledPixmap(3X) UNIX System V XmGetScaledPixmap(3X)
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 Widgetargument 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
XmGetScaledPixmapapplies a ratio equals to (printer
resolution / default pixmap resolution) before creating the
Pixmap on the widget's Screen. Otherwise, the
scaling_ratiois used in scaling both dimensions of the image
being converted as a Pixmap.
XmGetScaledPixmap completes the XmGetPixmapByDepth existing
API by making use of the XmNdefaultPixmapResolutionof 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.
Page 1 (printed 7/20/06)
XmGetScaledPixmap(3X) UNIX System V XmGetScaledPixmap(3X)
ERRORS/WARNINGS
Same as for XmGetPixmapByDepth.
SEE ALSO
XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3)
Page 2 (printed 7/20/06)