1DMXGetScreenAttributes(3)  Library Functions Manual  DMXGetScreenAttributes(3)
2
3
4

NAME

6       DMXGetScreenAttributes - determine back-end screen attributes
7

SYNOPSIS

9       #include <X11/extensions/dmxext.h>
10
11       Bool DMXGetScreenAttributes(Display *dpy,
12                                   int screen,
13                                   DMXScreenAttributes *attr);
14

DESCRIPTION

16       DMXGetScreenAttributes()  returns  the  attributes  for  the single DMX
17       screen specified in screen.
18
19       The DMXScreenAttributes structure is:
20
21       typedef struct {
22           char         *displayName;
23           int          logicalScreen;
24
25           unsigned int screenWindowWidth;
26           unsigned int screenWindowHeight;
27           int          screenWindowXoffset;
28           int          screenWindowYoffset;
29
30           unsigned int rootWindowWidth;
31           unsigned int rootWindowHeight;
32           int          rootWindowXoffset;
33           int          rootWindowYoffset;
34
35           int          rootWindowXorigin;
36           int          rootWindowYorigin;
37       } DMXScreenAttributes;
38
39       displayName is the name used to  open  the  display,  either  from  the
40       Xdmx(1) command-line or from the configuration file.
41
42       logicalScreen  is  the  value  of  the  screen that that Xdmx(1) server
43       exports to clients.  When Xinerama is in use, this value is typically 0
44       for all values of physicalScreen.  If Xinerama is in use, rootWindowXo‐
45       rigin and rootWindowYorigin specify where the physical screen is  posi‐
46       tioned in the global Xinerama coordinate system.  Otherwise, these val‐
47       ues are set to 0.
48
49       screenWindowWidth, screenWindowHeight, screenWindowXoffset, and screen‐
50       WindowYoffset are a geometry specification (see X(7x)) for the location
51       of the DMX screen on the back-end screen.  The coordinate system of the
52       back-end display is used for these values.
53
54       rootWindowWidth,   rootWindowHeight,  rootWindowXoffset,  and  rootWin‐
55       dowYoffset are a geometry specification (see X(7x)) for the location of
56       the  root  window  on  the screen window.  The coordinate system of the
57       screen window is used.  In most cases, the root window  will  have  the
58       same  geometry  as the DMX screen window, and will occupy the same area
59       of the back-end display.  (This would not be the case, for example,  if
60       automatic projector alignment is used.)
61

RETURN VALUE

63       DMXGetScreenAttributes() returns True unless there is a protocol error.
64
65       DMXGetScreenAttributes() can generate BadValue errors.
66

SEE ALSO

68       DMXGetScreenCount(3), DMXChangeScreensAttributes(3), DMX(3), Xdmx(1)
69
70
71
72X Version 11                     libdmx 1.1.4        DMXGetScreenAttributes(3)
Impressum