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)