DMXChangeScreensAttributes(3)

NAME

   DMXChangeScreensAttributes - change back-end screen attributes

SYNOPSIS

   #include <X11/extensions/dmxext.h>

   int DMXChangeScreensAttributes(Display *dpy,
                                  int screen_count,
                                  int *screens,
                                  int mask_count,
                                  unsigned int *masks,
                                  DMXScreenAttributes *attr,
                                  int *error_screen);

DESCRIPTION

   DMXChangeScreensAttributes()  changes  the  geometries and positions of
   the DMX screen  and  DMX  root  windows  on  the  back-end  X  servers.
   screen_count  specifies  the number of screens to be changed.  For each
   screen, the screen number is placed in screens, an  attribute  mask  is
   placed  in  masks,  and  a DMXScreenAttributes structure is included in
   attr.

   An  explanation  of  the  DMXScreenAttributes  structure  is  given  in
   DMXGetScreenAttributes(3).

   The values that are used to compute each value in masks are as follows

   DMXScreenWindowWidth
   DMXScreenWindowHeight
   DMXScreenWindowXoffset
   DMXScreenWindowYoffset
   DMXRootWindowWidth
   DMXRootWindowHeight
   DMXRootWindowXoffset
   DMXRootWindowYoffset
   DMXRootWindowXorigin
   DMXRootWindowYorigin

   In  general, mask_count should be equal to screen_count.  However, as a
   convenience, mask_count may be less than  screen_count,  and  the  last
   entry in masks will then be used for all of the remaining screens.  For
   example, this allows identical changes to be made  to  several  screens
   using only one mask.

RETURN VALUE

   On success, 0 is returned.  Otherwise, error_screen is set to the value
   of the first screen in the list that caused the error  and  a  non-zero
   value is returned.  If screen_count or mask_count is less than 1, or if
   any of the attribute values are not  within  the  appropriate  bounding
   boxes,   DmxBadValue   is   returned.   If  a  protocol  error  occurs,
   DmxBadReply is returned.

   DMXChangeScreensAttributes()  can  generate  BadLength  (if  the   data
   provided   does   not   match  the  data  implicitly  required  by  the
   screen_count and mask_count values), BadValue (if the values in screens
   are not valid), and BadAlloc errors.

SEE ALSO

   DMXGetScreenCount(3), DMXGetScreenAttributes(3), DMX(3), Xdmx(1)

---

Free and Open Source Software