DMXGetScreenAttributes

DMXGetScreenAttributes(3X)			   DMXGetScreenAttributes(3X)



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, rootWin-
       dowXorigin 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  coordinant
       system of the back-end display is used for these values.

       rootWindowWidth,	 rootWindowHeight,  rootWindowXoffset,	and  rootWin-
       dowYoffset are a geometry specification (see X(7x)) for	the  location
       of the root window on the screen window.	 The coordinant 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(3X), DMXChangeScreenAttributes(3X), DMX(3X), Xdmx(1)



X.Org				Version 6.8.2	   DMXGetScreenAttributes(3X)