DMXGetScreenCount(3)

💖 DMXGetScreenCount(3) 💖

okay bestie so this is a page from the Library Functions Manual and it's all about DMXGetScreenCount — the lil function that tells you how many back-end screens your Xdmx(1) server is out here controlling. it's giving census taker energy fr fr 🗳️✨

---

✨ NAME ✨

DMXGetScreenCount — determine number of back-end screens 🖥️🖥️🖥️

---

🌸 SYNOPSIS 🌸

#include <X11/extensions/dmxext.h>

Bool DMXGetScreenCount(Display *dpy,
                       int *screen_count);

---

🦋 DESCRIPTION 🦋

so like, DMXGetScreenCount() returns the number of back-end screens that a Xdmx(1) server controls. that's it, that's the whole vibe 💅

now here's the tea: since a DMX screen usually fills all of the available area on a back-end server, there's usually a one-to-one correspondence between DMX screens and backend servers. cute, simple, iconic. 👑

BUT — and this is the plot twist 🫢 — it is also possible for a DMX screen to cover only part of the available area on a back-end server, and for more than one DMX screens to occupy different parts of the visible area on the same back-end server. so like, multiple DMX screens can lowkey share one back-end server's space. no cap.

also a DMX screen may be managed as a regular X screen in the Xdmx(1) server, or it may be joined with other DMX screens using Xinerama. main character energy either way. 🌈

---

⭐ RETURN VALUE ⭐

DMXGetScreenCount() sets screen_count and returns True — unless there's a protocol error. so basically: True = slay, protocol error = not slay. 💀

---

🎀 NOTES 🎀

if Xinerama is active, only one logical screen will be available to clients of the Xdmx(1) server. yes, only one. don't panic, bestie 🙈

however — and this is the important part — this call will accurately reflect the number of composite back-end screens that the Xdmx(1) server is using. so even when the clients only see one screen, this function is still out here telling you the real count. honest queen. 👑

---

💜 SEE ALSO 💜

• DMXGetScreenAttributes(3)
• DMXChangeScreensAttributes(3)
• DMX(3)
• Xdmx(1)

---

and that's the whole page bestie, go forth and count your screens 🫶✨ this was X Version 11, libdmx 1.1.5, and it's giving DMXGetScreenCount(3) in the best way possible. mwah 💋🎀