XMSETFONTUNITS(3)

💖 NAME 💖

okay so hi bestie!! 🫶 this page is all about XmSetFontUnits, and it lives in the (library call) section of the manual. What is it? Literally just a function that sets the font unit value for a display. That's her whole job. Simple. Iconic. Lowkey obsolete (we'll get there, and yes I'm already 😭 about it).

🎀 SYNOPSIS 🎀

#include <Xm/Xm.h>
void XmSetFontUnits(
Display * display,
int h_value,
int v_value);

✨ DESCRIPTION ✨

XmSetFontUnits is an external function you call to initialize font unit values. Why would you even want that? Because your app might want to specify resolution-independent data based on a global font size — that's the whole dream, the vision, the aesthetic. 🦋

🫶 THE VIBE CHECK THAT ACTUALLY MATTERS: this function must be called before any widgets with resolution-independent data are created. Before. Not during, not after, not "oops I'll just squeeze it in." It's giving "first line or it doesn't count," fr fr.

Want the full lore on resolution independence? Go read the XmNunitType resource description in the reference pages for XmGadget, XmManager, and XmPrimitive. 📚

Also important: this function sets the font units for all screens on the display. Every. Single. One. No picking favourites here. 💅

💀 NOTE, and bestie, I need you to sit down for this one: XmSetFontUnits is obsolete and exists purely for compatibility with previous releases. Instead of using this function, provide initial values or call XtSetValues for the XmScreen resources XmNhorizontalFontUnit and XmNverticalFontUnit. She's a legacy queen, but she is still legacy. No cap.

The arguments, one at a time, because we don't skip:

• display — Defines the display for which this font unit value is to be applied. 🖥️
• h_value — Specifies the value to be used for horizontal units in the conversion calculations.
• h_value — Specifies the value to be used for vertical units in the conversion calculations. 🙈

and yes, the page really does label that third one h_value too. It's the vertical one going by the description. I'm just the messenger. 🎀

🌈 RELATED 🌈

The girls that came before and the girls that come after, all linked up and thriving:

• XmConvertUnits(3)
• XmSetFontUnit(3)
• XmGadget(3)
• XmManager(3)
• XmPrimitive(3)
• XmScreen(3)

and that's the whole page, bestie!! 💜 we read it top to bottom, and down at the very bottom where the footer lives it just says XmSetFontUnits(library call) all over again — no version number, no date, just her name one more time for the road. slay, honestly. ✨🌸🦋