1DMXChangeScreensAttributes(3L)ibrary Functions ManuaDlMXChangeScreensAttributes(3)
2
3
4

NAME

6       DMXChangeScreensAttributes - change back-end screen attributes
7

SYNOPSIS

9       #include <X11/extensions/dmxext.h>
10
11       int DMXChangeScreensAttributes(Display *dpy,
12                                      int screen_count,
13                                      int *screens,
14                                      int mask_count,
15                                      unsigned int *masks,
16                                      DMXScreenAttributes *attr,
17                                      int *error_screen);
18

DESCRIPTION

20       DMXChangeScreensAttributes()  changes  the  geometries and positions of
21       the DMX screen  and  DMX  root  windows  on  the  back-end  X  servers.
22       screen_count  specifies  the number of screens to be changed.  For each
23       screen, the screen number is placed in screens, an  attribute  mask  is
24       placed  in  masks,  and  a DMXScreenAttributes structure is included in
25       attr.
26
27       An  explanation  of  the  DMXScreenAttributes  structure  is  given  in
28       DMXGetScreenAttributes(3).
29
30       The values that are used to compute each value in masks are as follows
31
32       DMXScreenWindowWidth
33       DMXScreenWindowHeight
34       DMXScreenWindowXoffset
35       DMXScreenWindowYoffset
36       DMXRootWindowWidth
37       DMXRootWindowHeight
38       DMXRootWindowXoffset
39       DMXRootWindowYoffset
40       DMXRootWindowXorigin
41       DMXRootWindowYorigin
42
43       In  general, mask_count should be equal to screen_count.  However, as a
44       convenience, mask_count may be less than  screen_count,  and  the  last
45       entry in masks will then be used for all of the remaining screens.  For
46       example, this allows identical changes to be made  to  several  screens
47       using only one mask.
48

RETURN VALUE

50       On success, 0 is returned.  Otherwise, error_screen is set to the value
51       of the first screen in the list that caused the error  and  a  non-zero
52       value is returned.  If screen_count or mask_count is less than 1, or if
53       any of the attribute values are not  within  the  appropriate  bounding
54       boxes,   DmxBadValue   is   returned.   If  a  protocol  error  occurs,
55       DmxBadReply is returned.
56
57       DMXChangeScreensAttributes() can generate BadLength (if the  data  pro‐
58       vided  does  not match the data implicitly required by the screen_count
59       and mask_count values), BadValue (if the  values  in  screens  are  not
60       valid), and BadAlloc errors.
61

SEE ALSO

63       DMXGetScreenCount(3), DMXGetScreenAttributes(3), DMX(3), Xdmx(1)
64
65
66
67X Version 11                     libdmx 1.1.4    DMXChangeScreensAttributes(3)
Impressum