DMXGetScreenAttributes(3)				     Library Functions Manual					 DMXGetScreenAttributes(3)

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 loca-
       tion 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.2 					 DMXGetScreenAttributes(3)