1XmGetScaledPixmap(library call)                XmGetScaledPixmap(library call)
2
3
4

NAME

6       XmGetScaledPixmap — read a pixmap file and scale it according to pixmap
7       and print resolution
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XtEnum XmGetScaledPixmap(
12       Widget widget,
13       String image_name,
14       Pixel foreground,
15       Pixel background,
16       int depth,
17       Double scaling_ratio);
18

DESCRIPTION

20       XmGetScaledPixmap uses its Widget argument to look up for a Print Shell
21       ancestor  to  get the pixmap resolution and the default printer resolu‐
22       tion information to be used if scaling_ratio ==0.
23
24       If scaling is 0, and a valid PrintShell  is  present  XmGetScaledPixmap
25       applies  a ratio equals to (printer resolution / default pixmap resolu‐
26       tion) before creating the Pixmap on the  widget's  Screen.   Otherwise,
27       the scaling_ratio is used in scaling both dimensions of the image being
28       converted as a Pixmap.
29
30       XmGetScaledPixmap completes the XmGetPixmapByDepth existing API by mak‐
31       ing  use of the XmNdefaultPixmapResolution of the rooting XmPrintShell.
32       Refer to the XmGetPixmapByDepth documentation for details.
33
34       widget    Widget used to determine the default  pixmap  resolution  (of
35                 the print shell ancestor).
36
37       image_name
38                 See XmGetPixmapByDepth for description.
39
40       foreground
41                 See XmGetPixmapByDepth for description.
42
43       background
44                 See XmGetPixmapByDepth for description.
45
46       depth     See XmGetPixmapByDepth for description.
47
48       scaling_ratio
49                 Indicate the scaling ratio to be applied, or 0.
50

RETURN VALUE

52       Returns Pixmap or NULL if failed.
53

ERRORS/WARNINGS

55       Same as for XmGetPixmapByDepth.
56

SEE ALSO

58       XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3)
59
60
61
62                                               XmGetScaledPixmap(library call)
Impressum