DMXGetScreenAttributes(3) 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, rootWindowXo-
rigin and rootWindowYorigin specify where the physical screen is posi-
tioned in the global Xinerama coordinate system. Otherwise, these val-
ues are set to 0.
screenWindowWidth, screenWindowHeight, screenWindowXoffset, and screen-
WindowYoffset are a geometry specification (see X(7x)) for the location
of the DMX screen on the back-end screen. The coordinant system of the
back-end display is used for these values.
rootWindowWidth, rootWindowHeight, rootWindowXoffset, and rootWin-
dowYoffset are a geometry specification (see X(7x)) for the location of
the root window on the screen window. The coordinant 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(3X), DMXChangeScreenAttributes(3X), DMX(3X), Xdmx(1)
X Version 11 libdmx 1.0.2 DMXGetScreenAttributes(3)
Mac OS X 10.6 X11 - Generated Sun Mar 7 12:29:33 CST 2010