DragonFly On-Line Manual Pages

DMXGetScreenAttributes(3)                   DragonFly Library Functions Manual

NAME
       DMXGetScreenAttributes - determine back-end screen attributes

SYNOPSIS
       #include <X11/extensions/dmxext.h>

       Bool DMXGetScreenAttributes(Display *dpy,
                                   int screen,
                                   DMXScreenAttributes *attr);

DESCRIPTION
       DMXGetScreenAttributes() returns the attributes for the single DMX
       screen specified in screen.

       The DMXScreenAttributes structure is:

       typedef struct {
           char         *displayName;
           int          logicalScreen;

           unsigned int screenWindowWidth;
           unsigned int screenWindowHeight;
           int          screenWindowXoffset;
           int          screenWindowYoffset;

           unsigned int rootWindowWidth;
           unsigned int rootWindowHeight;
           int          rootWindowXoffset;
           int          rootWindowYoffset;

           int          rootWindowXorigin;
           int          rootWindowYorigin;
       } DMXScreenAttributes;

       displayName is the name used to open the display, either from the
       Xdmx(1) command-line or from the configuration file.

       logicalScreen is the value of the screen that that Xdmx(1) server
       exports to clients.  When Xinerama is in use, this value is typically 0
       for all values of physicalScreen.  If Xinerama is in use,
       rootWindowXorigin and rootWindowYorigin specify where the physical
       screen is positioned in the global Xinerama coordinate system.
       Otherwise, these values are set to 0.

       screenWindowWidth, screenWindowHeight,  screenWindowXoffset, and
       screenWindowYoffset are a geometry specification (see X(7x)) for the
       location of the DMX screen on the back-end screen.  The coordinate
       system of the back-end display is used for these values.

       rootWindowWidth, rootWindowHeight,  rootWindowXoffset, and
       rootWindowYoffset are a geometry specification (see X(7x)) for the
       location of the root window on the screen window.  The coordinate
       system of the screen window is used.  In most cases, the root window
       will have the same geometry as the DMX screen window, and will occupy
       the same area of the back-end display.  (This would not be the case,
       for example, if automatic projector alignment is used.)

RETURN VALUE
       DMXGetScreenAttributes() returns True unless there is a protocol error.

       DMXGetScreenAttributes() can generate BadValue errors.

SEE ALSO
       DMXGetScreenCount(3),  DMXChangeScreensAttributes(3),  DMX(3), Xdmx(1)

X Version 11                     libdmx 1.1.3        DMXGetScreenAttributes(3)