DMXDesktopAttributes(3)

💖 DMXDesktopAttributes(3) 💖

okay bestie, welcome to the Library Functions Manual corner of the group chat ✨ this one's all about DMXGetDesktopAttributes and it's genuinely so chill, like a lil vibe check for your whole desktop 🦋

---

🌸 NAME 🌸

DMXGetDesktopAttributes — determine global bounding box

---

✨ SYNOPSIS ✨

#include <X11/extensions/dmxext.h>

Bool DMXGetDesktopAttributes(Display *dpy,
                             DMXDesktopAttributes *attr);

---

💅 DESCRIPTION 💅

so DMXGetDesktopAttributes() hands you back the tea about your desktop, and it drops it all into a DMXDesktopAttributes, which looks exactly like this:

typedef struct {
    unsigned int width;
    unsigned int height;
    int          shiftX;
    int          shiftY;
} DMXDesktopAttributes;

the size of the global bounding box lives in width and height, no cap 📏✨ and the shiftX and shiftY values? bestie they will always be 0. always. every single time. iconic behaviour honestly 💀

the global bounding box gets computed whether or not Xinerama is active, but like… it's only actually useful when you're using Xinerama, so keep that in mind 🙈

also important: the global bounding box that Xdmx(1) uses may be larger than the Xinerama screen size, because of info in the configuration file 👑 so don't be surprised if it's giving extra.

---

🔥 RETURN VALUE 🔥

DMXGetDesktopAttributes() returns True unless there's a protocol error 😭 that's it, that's the whole vibe check.

---

🫶 SEE ALSO 🫶

• DMXChangeDesktopAttributes(3)
• DMX(3)
• Xdmx(1)

---

X Version 11 ✨ libdmx 1.1.5 — that's the source and version, bestie, and this page is DMXDesktopAttributes(3) 💖 mwah, go read the other ones, ily, periodt 🌈🎀🦋