Prima::...:XQuartz(3)

💅 Prima::sys::XQuartz

okay so bestie, welcome to the User Contributed Perl Documentation corner of the world ✨ this little page is all about Prima::sys::XQuartz, and honestly? it's giving "niche but important" and we're obsessed 🫶

---

🌸 NAME 🌸

Prima::sys::XQuartz — literally the MacOSX/XQuartz facilities page, no cap 💖

---

🦋 DESCRIPTION 🦋

so picture this: XQuartz is out here emulating the X11 environment for you, but with a few little limits, and we need to talk about them 👀

XQuartz cannot grab bits from the screen, and it also hides the top-level menu from screen coordinates accessible for X11 clients. like, the vibes are immaculate but the geometry is not 🙈

for example (and this is the example, fr fr): a Mac with 1024x768 resolution will only report f.ex. 1024x746 size to Prima. the math is mathing, the menu bar just ate the rest 💀

but here's the slay: if Prima is compiled with the Cocoa library, the get_fullscreen_image method circumvents these limitations and returns a shot of the whole screen, including the application menu 👑✨ periodt.

⚠️ heads up bestie: screen grabbing has to be allowed by the user or the administrator. like, you can't just show up and screenshot, that's not the vibe.

here's the whole quest, step by step:

1. Choose the Apple menu 🍓
2. System Preferences
3. click Security & Privacy
4. then click Privacy
5. click on an icon on the left lower corner to allow changes 🔓
6. then, in the screen recording tab, add XQuartz to the list of allowed applications 💅

💀 and ngl, it might not work if you run your application from a (remote) ssh session — the author literally couldn't find how to enable screen grabbing for sshd. so that's just how it is, iykyk. 😭

---

🎀 AUTHOR 🎀

Dmitry Karasik, <dmitry@karasik.eu.org>. 💖

---

⭐ SEE ALSO ⭐

• Prima::Dialog::FileDialog — go read it, bestie, it's right there 🌈

---

and that's the whole page, gorgeous 🌸 stay iconic, keep your screen recording permissions on point, and remember: perl v5.42.0 dropped this on 2024-08-20, filed under Prima::...:XQuartz(3) 🦋 mwah 💋