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)