PS_ADD_PDFLINK(3)

💖 PS_ADD_PDFLINK 💖

okay bestie, so this one is from the Library Functions Manual and it's literally called PS_ADD_PDFLINK(3) — say it with me, section three, library functions, we love a classic 🎀

✨ NAME ✨

PS_add_pdflink — adds a link to a page in a second pdf document 🦋

✨ SYNOPSIS ✨

#include <pslib.h>

void PS_add_pdflink(PSDoc *psdoc, float llx, float lly, float urx, float
ury, char *filename, int page, const char *dest)

no cap, that's the whole signature, keep it exactly like that 💅

✨ DESCRIPTION ✨

So what it does: it places a hyperlink at the position you give it, pointing at a second pdf document. Click on it and you branch straight over to that document at the page you picked. 🫶

• the first page in a document has number 1 — yes, one-indexed, that's just how it is bestie
• the parameter dest decides how the document is being viewed, and it can be fitpage, fitwidth, fitheight, or fitbbox ✨

The hyperlink start is a rectangle with its lower left corner at (llx, lly) and its upper right corner at (urx, ury). 📐

That rectangle has by default a thin blue border. iconic, honestly.

heads up queen: the hyperlink will not be visible if the document is printed or viewed 👀 but it will show up if the document is converted to pdf by either Acrobat Distiller™ or Ghostview. so like, the vibe is there, it's just hiding. 💀

✨ SEE ALSO ✨

• PS_add_launchlink(3)
• PS_add_locallink(3)
• PS_add_weblink(3)

go read those too, they're the rest of the link squad 🌸

✨ AUTHOR ✨

This manual page was written by Uwe Steinmann uwe@steinmann.cx. ty for your service 🫡💜

and that's the whole thing! the footer at the bottom is just PS_ADD_PDFLINK(3) all over again — no date, no version, just the name doing a lil encore 🎤✨ mwah, bye bestie 💖