1DMXAddScreen(3)            Library Functions Manual            DMXAddScreen(3)
2
3
4

NAME

6       DMXAddScreen - attach a new back-end screen
7

SYNOPSIS

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

DESCRIPTION

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  DMXChangeScreensAttributes(3)  and DMXGetScreenAttributes(3) func‐
27       tions.
28

RETURN VALUE

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

NOTES

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(3) API, this function uses screen for
45       both input and output.
46

SEE ALSO

48       DMXRemoveScreen(3),   DMXChangeScreensAttributes(3),    DMXGetScreenAt‐
49       tributes(3), DMX(3), Xdmx(1)
50
51
52
53X Version 11                     libdmx 1.1.3                  DMXAddScreen(3)
Impressum