PS_FINDFONT(3)

💖 PS_FINDFONT(3) 💖

okay bestie, welcome to the PS_findfont page — it's living in the Library Functions Manual, and it's about to teach you how to load a font like a boss. no cap. 🎀

✨ SYNOPSIS ✨

#include <pslib.h>

int PS_findfont(PSDoc *psdoc, const char *fontname, const char
*encoding, int embed)

🌸 DESCRIPTION 🌸

so basically PS_findfont loads a font for later use. that's the whole vibe. 💅

but listen — before you can actually output any text with a font you loaded, you have to set it with PS_setfont(3). like, no setfont, no text, that's just how it is. periodt.

this function also needs the adobe font metric file, because that's how it calculates the space used up by the characters. math is math. 🔥

now here's the part you gotta remember, bestie, because it's giving scope rules:

• a font loaded within a page will only be available on that page 🙈
• fonts that are meant to be used in the complete document have to be loaded before the first call of PS_begin_page(3) 👑
• calling PS_findfont(3) between pages will make that font available for all following pages ✨

PS_findfont will also try to load the file you pass in the encoding parameter. those encoding files use the same syntax as the ones used by dvips(1). inside them you'll find:

• a font encoding vector — which is currently not used but must be present (yes queen, it's decorative but mandatory 💀)
• a list of extra ligatures to extend the list of ligatures derived from the afm file

encoding can be NULL or the empty string if the default encoding (TeXBase1) shall be used. easy.

and if you set the encoding to builtin? then there's no reencoding at all and the font specific encoding gets used instead. this is very useful with symbol fonts — lowkey iconic. 🦋

oh and one more thing: all files get searched first in the current directory and then in the directories set by the parameter SearchPath. search order matters, iykyk. 🔍

🫶 RETURN VALUE 🫶

returns the identifier of the font, or zero in case of an error. and the identifier? it's a positiv number. (that's a typo in the source and I'm keeping it, it's part of the lore now 💀✨)

🌈 SEE ALSO 🌈

• PS_setfont(3)
• PS_begin_page(3)

👑 AUTHOR 👑

this manual page was written by Uwe Steinmann <uwe@steinmann.cx>.

and that's the whole page, bestie — shoutout to the PS_FINDFONT(3) footer and the Library Functions Manual it came from, mwah 💖🎀✨