NAME

       DMXChangeDesktopAttributes - change global bounding box

SYNOPSIS

       #include <X11/extensions/dmxext.h>

       int DMXChangeDesktopAttributes(Display *dpy,
                                      unsigned int mask,
                                      DMXDesktopAttributes *attr);

DESCRIPTION

       DMXChangeDesktopAttributes()  resizes  the  bounding  box  of  the  whole  screen when using the Xinerama
       extension.  Otherwise, it has no effect on the screen layout.  An attribute mask is placed  in  mask  and
       the attributes to change are placed in attr.

       The values that are used to compute mask are as follows:

       DMXDesktopWidth
       DMXDesktopHeight
       DMXDesktopShiftX
       DMXDesktopShiftY

       The DMXDesktopAttributes structure is:

       typedef struct {
           unsigned int width;
           unsigned int height;
           int          shiftX;
           int          shiftY;
       } DMXDesktopAttributes;

       width   and   height  specify the new width and height for the bounding box.  shiftX  and  shiftY specify
       where the Xinerama origin will be placed with respect to the origin of the new bounding box.  This allows
       the  left  and  upper edges of the bounding box to be changed without changing the visual position of the
       windows on the desktop.  If width  or  height is not specified, the current  values  will  be  used.   If
       shiftX  or  shiftY is not specified, 0 will be used.

       All  coordinates  are  in  the global DMX coordinate system.  If Xinerama is not active, an error will be
       generated.

RETURN VALUE

       DMXChangeDesktopAttributes() will return  0  on  success,  DmxBadXinerama  if  Xinerama  is  not  active,
       DmxBadValue if the size of the bounding box is too large, and DmxBadReply if there was a protocol error.

       DMXChangeDesktopAttributes()  can  generate  BadLength  (if  the request is malformed, which should never
       happen when using this library interface), and BadValue (if any values are out of range).

SEE ALSO

       DMXGetDesktopAttributes(3), DMX(3), Xdmx(1)