DMXAddScreen(3)

📦
version 1.1.5 · 2 versions
, in epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 DMXAddScreen — from the libdmx crew (that's the Library Functions Manual, bestie) 💖

okay so real talk, this one's about gluing a whole new back-end screen onto your Xdmx setup. it's giving "let me in" energy. let's go 🫶

✨ NAME ✨

DMXAddScreen — attach a new back-end screen 🌸

🦋 SYNOPSIS 🦋

#include <X11/extensions/dmxext.h>

Bool DMXAddScreen(Display *dpy,
                  const char *displayName,
                  unsigned int mask,
                  DMXScreenAttributes *attr,
                  int *screen);

👑 DESCRIPTION 👑

DMXAddScreen() attaches a back-end screen to the Xdmx(1) server, and it slots it right into the spot of the previously detached back-end server that screen is pointing at. like, it's taking over the vacated seat. iconic behavior honestly.

displayName is the name of the new back-end display, mask says which fields in attr are actually active, and screen hands you back the new Xdmx(1) screen number for the screen that just got attached. ✨

the info chillin' in mask and attr is literally identical to what DMXChangeScreensAttributes(3) and DMXGetScreenAttributes(3) use. same vibes, same data, no cap.

🌈 RETURN VALUE 🌈

DMXAddScreen() returns True if the screen was successfully attached, and False otherwise. periodt.

and False comes back at you when:

  • the -addremovescreens command line option was not specified on the Xdmx(1) command line 😭
  • the input value of screen is out of range
  • screen is not currently detached
  • displayName cannot be opened
  • it has unexpected visuals
  • or it has characteristics that do not match the previously detached screen 💀

DMXAddScreen() can generate BadLength, BadAlloc, and BadValue errors.

🎀 NOTES 🎀

attributes that are not specified will default to 0. and bestie, that may lead to unintended results. not me warning you twice, but like… be careful 🙈

unlike the other functions in the DMX(3) API, this one uses screen for both input and output. she's doing double duty. main character energy fr fr. 💅

🌸 SEE ALSO 🌸

X Version 11, libdmx 1.1.5, DMXAddScreen(3) — that's the whole vibe check, bestie, mwah 💖 stay hydrated, read your man pages, and go attach something slay ✨🦋

📦 where this page comes from