---
name: "XmGetScaledPixmap"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmGetScaledPixmap"
---

# XmGetScaledPixmap(3)

read a pixmap file and scale it according to pixmap and print resolution

## 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)](/XmPrintSetup/3.md), [**XmPrintShell**(3)](/XmPrintShell/3.md), [**XmRedisplayWidget**(3)](/XmRedisplayWidget/3.md)