DMXGetScreenAttributes(3X)

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(3X)