dmxaddscreen(3) [posix man page]
DMXAddScreen(3) Library Functions Manual DMXAddScreen(3) 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 -addremove- screens command line option was not specified on the Xdmx(1) command line, the input value of screen is out of range, screen is not cur- rently 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) X Version 11 libdmx 1.1.2 DMXAddScreen(3)
Check Out this Related Man Page
DMXGetScreenAttributes(3) Library Functions Manual DMXGetScreenAttributes(3) NAME
DMXGetScreenAttributes - determine back-end screen attributes SYNOPSIS
#include <X11/extensions/dmxext.h> Bool DMXGetScreenAttributes(Display *dpy, int screen, DMXScreenAttributes *attr); DESCRIPTION
DMXGetScreenAttributes() returns the attributes for the single DMX screen specified in screen. The DMXScreenAttributes structure is: typedef struct { char *displayName; int logicalScreen; unsigned int screenWindowWidth; unsigned int screenWindowHeight; int screenWindowXoffset; int screenWindowYoffset; unsigned int rootWindowWidth; unsigned int rootWindowHeight; int rootWindowXoffset; int rootWindowYoffset; int rootWindowXorigin; int rootWindowYorigin; } DMXScreenAttributes; displayName is the name used to open the display, either from the Xdmx(1) command-line or from the configuration file. logicalScreen is the value of the screen that that Xdmx(1) server exports to clients. When Xinerama is in use, this value is typically 0 for all values of physicalScreen. If Xinerama is in use, rootWindowXorigin and rootWindowYorigin specify where the physical screen is positioned in the global Xinerama coordinate system. Otherwise, these values are set to 0. screenWindowWidth, screenWindowHeight, screenWindowXoffset, and screenWindowYoffset are a geometry specification (see X(7x)) for the loca- tion of the DMX screen on the back-end screen. The coordinate system of the back-end display is used for these values. rootWindowWidth, rootWindowHeight, rootWindowXoffset, and rootWindowYoffset are a geometry specification (see X(7x)) for the location of the root window on the screen window. The coordinate system of the screen window is used. In most cases, the root window will have the same geometry as the DMX screen window, and will occupy the same area of the back-end display. (This would not be the case, for example, if automatic projector alignment is used.) RETURN VALUE
DMXGetScreenAttributes() returns True unless there is a protocol error. DMXGetScreenAttributes() can generate BadValue errors. SEE ALSO
DMXGetScreenCount(3), DMXChangeScreensAttributes(3), DMX(3), Xdmx(1) X Version 11 libdmx 1.1.2 DMXGetScreenAttributes(3)