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 location 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)