XMGETSCALEDPIXMAP(3)

💖 XmGetScaledPixmap — the library call, but make it fashion 💖

okay so bestie, today we're talking about XmGetScaledPixmap, a library call, and no it's not just "another pixmap function," it's the one that actually respects your printer's resolution. it's giving thoughtful. it's giving considerate. it's giving 🎀

---

✨ 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 🦋

okay so here's the tea ☕. XmGetScaledPixmap takes its Widget argument and goes looking up the family tree for a Print Shell ancestor, so it can grab the pixmap resolution and the default printer resolution info — and those are the ones it's gonna use if scaling_ratio == 0. lowkey iconic behavior honestly.

So if the scaling is 0, and there's a valid PrintShell sitting up there in the ancestor chain, XmGetScaledPixmap applies a ratio that equals:

(printer resolution / default pixmap resolution)

…and it does all that before creating the Pixmap on the widget's Screen. periodt. 💅

Otherwise — if we're not in the scaling-is-0 situation — the scaling_ratio you passed in gets used to scale both dimensions of the image being converted as a Pixmap. both of them. no half-measures. 🫶

And here's the glow-up: XmGetScaledPixmap completes the existing XmGetPixmapByDepth API by making use of the XmNdefaultPixmapResolution of the rooting XmPrintShell. so if you want the full deets, go read the XmGetPixmapByDepth documentation, bestie — it's all there. 📖✨

🍓 the arguments, one by one 🍓

• widget — the Widget used to determine the default pixmap resolution (of the print shell ancestor). it's the one doing the ancestor-hunting. main character energy fr fr. 👑
• image_name — see XmGetPixmapByDepth for description.
• foreground — see XmGetPixmapByDepth for description.
• background — see XmGetPixmapByDepth for description.
• depth — see XmGetPixmapByDepth for description.
• scaling_ratio — indicates the scaling ratio to be applied, or 0. that's it, that's the whole job. 🎀

---

💜 RETURN VALUE 💜

Returns Pixmap, or NULL if it failed. 😭 so like… check it. always check it. ngl that's just good manners.

---

🔥 ERRORS/WARNINGS 🔥

Same as for XmGetPixmapByDepth. that's the whole warning section, babes — go look at the other page if you need the full list. 💀

---

🌈 SEE ALSO 🌈

• XmPrintSetup(3)
• XmPrintShell(3)
• XmRedisplayWidget(3)

---

and that's the whole page, bestie!! 💖✨ this was XmGetScaledPixmap(library call) — the library-call era of the manual, no cap. go forth and scale your pixmaps responsibly. mwah 🫶🎀🦋