1DMXChangeDesktopAttributes(3X)                  DMXChangeDesktopAttributes(3X)
2
3
4

NAME

6       DMXChangeDesktopAttributes - change global bounding box
7

SYNOPSIS

9       #include <X11/extensions/dmxext.h>
10
11       int DMXChangeDesktopAttributes(Display *dpy,
12                                      unsigned int mask,
13                                      DMXDesktopAttributes *attr);
14

DESCRIPTION

16       DMXChangeDesktopAttributes()  resizes  the  bounding  box  of the whole
17       screen when using the Xinerama extension.  Otherwise, it has no  effect
18       on  the  screen  layout.   An  attribute mask is placed in mask and the
19       attributes to change are placed in attr.
20
21       The values that are used to compute mask are as follows:
22
23       DMXDesktopWidth
24       DMXDesktopHeight
25       DMXDesktopShiftX
26       DMXDesktopShiftY
27
28       The DMXDesktopAttributes structure is:
29
30       typedef struct {
31           unsigned int width;
32           unsigned int height;
33           int          shiftX;
34           int          shiftY;
35       } DMXDesktopAttributes;
36
37       width  and  height specify the new width and height  for  the  bounding
38       box.   shiftX   and   shiftY  specify where the Xinerama origin will be
39       placed with respect to the origin of the new bounding box.  This allows
40       the  left  and  upper  edges  of the bounding box to be changed without
41       changing the visual position of the windows on the desktop.   If  width
42       or   height  is  not  specified,  the  current values will be used.  If
43       shiftX  or  shiftY is not specified, 0 will be used.
44
45       All coordinants are in the global DMX coordinant system.   If  Xinerama
46       is not active, an error will be generated.
47

RETURN VALUE

49       DMXChangeDesktopAttributes()  will  return 0 on success, DmxBadXinerama
50       if Xinerama is not active, DmxBadValue if the size of the bounding  box
51       is too large, and DmxBadReply if there was a protocol error.
52
53       DMXChangeDesktopAttributes()  can generate BadLength (if the request is
54       malformed, which should never happen when  using  this  library  inter‐
55       face), and BadValue (if any values are out of range).
56

SEE ALSO

58       DMXGetDesktopAttributes(3X), DMX(3X), Xdmx(1)
59
60
61
62X Version 11                     libdmx 1.0.2   DMXChangeDesktopAttributes(3X)
Impressum