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,
in place of the previously detached back-end server specified by
screen.
displayName is the name of the new back-end display,
mask
specifies the field in
attr that are active, and
screen returns
the new
Xdmx(1) screen number for the attached screen.
The information stored in
mask and attr is identical to that used by the
DMXChangeScreensAttributes(3) and
DMXGetScreenAttributes(3)
functions.
RETURN VALUE¶
DMXAddScreen() will return
True if the screen was successfully
attached, and
False otherwise.
False will be returned if 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,
has unexpected visuals, or 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. This may lead to unintended
results.
Unlike other functions in the
DMX(3) API, this function uses
screen for both input and output.
SEE ALSO¶
DMXRemoveScreen(3),
DMXChangeScreensAttributes(3),
DMXGetScreenAttributes(3),
DMX(3),
Xdmx(1)