1DMXAddScreen(3X) DMXAddScreen(3X)
2
3
4
6 DMXAddScreen - attach a new back-end screen
7
9 #include <X11/extensions/dmxext.h>
10
11 Bool DMXAddScreen(Display *dpy,
12 const char *displayName,
13 unsigned int mask,
14 DMXScreenAttributes *attr,
15 int *screen);
16
18 DMXAddScreen() attaches a back-end screen to the Xdmx(1) server, in
19 place of the previously detached back-end server specified by screen.
20
21 displayName is the name of the new back-end display, mask specifies the
22 field in attr that are active, and screen returns the new Xdmx(1)
23 screen number for the attached screen.
24
25 The information stored in mask and attr is identical to that used by
26 the DMXChangeScreenAttributes(3X) and DMXGetScreenAttribues(3X) func‐
27 tions.
28
30 DMXAddScreen() will return True if the screen was successfully
31 attached, and False otherwise. False will be returned if the
32 -addremovescreens command line option was not specified on the Xdmx(1)
33 command line, the input value of screen is out of range, screen is not
34 currently detached, displayName cannot be opened, has unexpected visu‐
35 als, or has characteristics that do not match the previously detached
36 screen.
37
38 DMXAddScreen() can generate BadLength, BadAlloc, and BadValue errors.
39
41 Attributes that are not specified will default to 0. This may lead to
42 unintended results.
43
44 Unlike other functions in the DMX(3X) API, this function uses screen
45 for both input and output.
46
48 DMXRemoveScreen(3X), DMXChangeScreenAttributes(3X), DMXGetScreenAt‐
49 tributes(3X), DMX(3X), Xdmx(1)
50
51
52
53X Version 11 libdmx 1.0.2 DMXAddScreen(3X)