DragonFly On-Line Manual Pages

DMXChangeScreensAttributes(3)               DragonFly Library Functions Manual

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)

X Version 11                     libdmx 1.1.3    DMXChangeScreensAttributes(3)