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

---

Free and Open Source Software