MirOS Manual: DMXChangeScreensAttributes(3)

DMXChangeScreensAttriUNIXsProgrammeDMXChangeScreensAttributes(3X)

NAME

     DMXChangeScreensAttributes - change back-end screen attri-
     butes

SYNOPSIS

     #include <X11/extensions/dmxext.h>

     int DMXChangeScreensAttributes(Display *dpy,
                                    int screen_count,
                                    int *screens,
                                    int mask_count,
                                    unsigned int *masks,
                                    DMXScreenAttributes *attr,
                                    int *error_screen);

DESCRIPTION

     DMXChangeScreensAttributes() changes the geometries and
     positions of the DMX screen and DMX root windows on the
     back-end X servers. screen_count specifies the number of
     screens to be changed.  For each screen, the screen number
     is placed in screens, an attribute mask is placed in masks,
     and a DMXScreenAttributes structure is included in attr.

     An explanation of the DMXScreenAttributes structure is given
     in DMXGetScreenAttributes(3X).

     The values that are used to compute each value in masks are
     as follows

     DMXScreenWindowWidth
     DMXScreenWindowHeight
     DMXScreenWindowXoffset
     DMXScreenWindowYoffset
     DMXRootWindowWidth
     DMXRootWindowHeight
     DMXRootWindowXoffset
     DMXRootWindowYoffset
     DMXRootWindowXorigin
     DMXRootWindowYorigin

     In general, mask_count should be equal to screen_count. How-
     ever, as a convenience, mask_count may be less than
     screen_count, and the last entry in masks will then be used
     for all of the remaining screens.  For example, this allows
     identical changes to be made to several screens using only
     one mask.

RETURN VALUE

     On success, 0 is returned.  Otherwise, error_screen is set
     to the value of the first screen in the list that caused the
     error and a non-zero value is returned.  If screen_count or
     mask_count is less than 1, or if any of the attribute values

XFree86                   Version 4.5.0                         1

DMXChangeScreensAttriUNIXsProgrammeDMXChangeScreensAttributes(3X)

     are not within the appropriate bounding boxes, DmxBadValue
     is returned.  If a protocol error occurs, DmxBadReply is
     returned.

     DMXChangeScreensAttributes() can generate BadLength (if the
     data provided does not match the data implicitly required by
     the screen_count and mask_count values), BadValue (if the
     values in screens are not valid), and BadAlloc errors.

SEE ALSO

     DMXGetScreenCount(3X), DMXGetScreenAttributes(3X), DMX(3X),
     Xdmx(1)

XFree86                   Version 4.5.0                         2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.