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)

X Version 11                                      libdmx 1.1.4                     DMXChangeDesktopAttributes(3)