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 coordinants are in the global DMX coordinant 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)