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)