Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DMXChangeScreensAttributes(Library Functions ManuDMXChangeScreensAttributes(3)

NAME
       DMXChangeScreensAttributes - change back-end screen attributes

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(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 en-
       try  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  pro-
       vided  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(3), DMXGetScreenAttributes(3),	DMX(3),	Xdmx(1)

X Version 11			 libdmx	1.1.3	 DMXChangeScreensAttributes(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DMXChangeScreensAttributes&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help