NAME
Prima::sys::XQuartz - MacOSX/XQuartz facilities
DESCRIPTION
XQuartz emulates the X11 environment with certain limits, namely, it cannot grab bits from the screen, and it also hides the top-level menu from screen coordinates accessible for X11 clients. For example, a Mac with 1024x768 resolution will only report f.ex. 1024x746 size to Prima. 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.
Note that screen grabbing has to be allowed by the user or the administrator. To do that, Choose the Apple menu, System Preferences, click Security & Privacy, then click Privacy. Click on an icon on the left lower corner to allow changes. Then, in the screen recording tab, add XQuartz to the list of allowed applications. Note that it might not work if you run your application from a (remote) ssh session - I couldn't find how to enable screen grabbing for sshd.
AUTHOR
Dmitry Karasik, <dmitry@karasik.eu.org>.