XineramaGetData(3X11) X11R6 XineramaGetData(3X11)
NAME
XineramaGetData - returns the state of the Xinerama
extension
SYNTAX
#include <X11/extensions/Xinerama.h>
Status XineramaGetData(
Display *dpy,
int screen_number,
XRectangle **rectangles_return,
int *count_return
);
ARGUMENTS
dpy Specifies the connection to the X server.
screen_number
Specifies a given Xinerama screen.
rectangles_return
Returns a list of rectangles corresponding to the
physical underlying screens (frame buffers).
count_return
Returns the number of physical underlying screens
(frame buffers).
DESCRIPTION
XineramaGetData returns the number of physical screens
(frame buffers) and their geometry, for the Xinerama screen
screen_number on the specified display connection dpy.
It is the client task to free the resulting rectangle list,
using XFree.
The return status is True for no errors, False otherwise.
DIAGNOSTICS
BadAlloc
The server failed to allocate the requested resource or
server memory.
BadValue
screen_number is out of range.
NOTES
Currently, all the physical screens managed by the Xinerama
enabled X server are combined into one active Xinerama
screen. This means that screen_number should be 0.
Xinerama is still not an Xorg standard. Thus, the interface
Page 1 (printed 7/20/06)
XineramaGetData(3X11) X11R6 XineramaGetData(3X11)
may still evolve.
XineramaGetData is a new interface replacing the deprecated
XineramaGetInfo from IRIX 6.5.15 and onwards.
SEE ALSO
XFree(3X11), Xinerama(3X11), XineramaActive(3X11),
XineramaGetCenterHint(3X11).
Page 2 (printed 7/20/06)