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)