DMXChangeScreensAttributes (3)
Leading comments
Copyright 2004 Red Hat Inc., Durham, North Carolina. All Rights Reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation on the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the followin...
NAME
DMXChangeScreensAttributes - change back-end screen attributesSYNOPSIS
#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(3).
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. However, 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 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.