PS_CREATE_GSTATE(3)

💅 PS_CREATE_GSTATE — the create-a-graphic-state page, bestie

okay so this is the man page for PS_create_gstate in the PS_CREATE_GSTATE(3) corner of the Library Functions Manual, and yes we're doing this whole thing together, hand in hand 🫶

✨ NAME ✨

PS_create_gstate — creates a new graphic state 🎀

🌸 SYNOPSIS 🌸

#include <pslib.h>

int PS_create_gstate(PSDoc *psdoc, const char *optlist)

like. that's the whole vibe. two args, one int coming back at you. iconic honestly 💖

🦋 DESCRIPTION 🦋

so bestie, real talk: this section is literally empty in the original page. no prose, no lore, nothing. it's giving minimalism, it's giving "the author said figure it out". I'm not gonna make stuff up about how it works because that would be lying to you and I would never 😭

what we do know is right there in the name and the signature: it creates a new graphic state, and it takes a PSDoc *psdoc and a const char *optlist. that's the tea 🍵

👑 RETURN VALUE 👑

• it hands you back the identifier of the graphic state 🎉
• or it gives you zero if something went wrong 💀 (that's the error case, no cap)
• and listen: that identifier is a positiv number — that's the exact spelling from the original, keepin' it verbatim for you 🫶

so like, if you get 0 back, that's not a cute little id, that's the error signal. do not pass go, do not collect your graphic state 🙈

💜 SEE ALSO 💜

• PS_set_gstate(3) — the other half of the duo, go read it next ⭐

🌈 AUTHOR 🌈

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

and that's the whole page, we ate and left no crumbs 💅

cute lil sign-off: this was PS_CREATE_GSTATE(3), hanging out in the Library Functions Manual, and the page signs off with its own name again like the main character it is ✨🌸 bye bestie, go create a graphic state 🎀