DMXGetScreenCount (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...

(The comments found at the beginning of the groff file "man3/DMXGetScreenCount.3".)

NAME

DMXGetScreenCount - determine number of back-end screens

SYNOPSIS

#include <X11/extensions/dmxext.h>

Bool DMXGetScreenCount(Display *dpy,
                       int *screen_count);

DESCRIPTION

DMXGetScreenCount() returns the number of back-end screens that a Xdmx(1) server controls. Since a DMX screen usually fills all of the available area on a back-end server, there is usually a one-to-one correspondence between DMX screens and backend servers. However, it is also possible for a DMX screen to cover only part of the available area on a back-end server, and for more than one DMX screens to occupy different parts of the visible area on the same back-end server.

A DMX screen may be managed as a regular X screen in the Xdmx(1) server or may be joined with other DMX screens using Xinerama.

RETURN VALUE

DMXGetScreenCount() sets screen_count and returns True unless there is a protocol error.

NOTES

If Xinerama is active, only one logical screen will be available to clients of the Xdmx(1) server. However, this call will accurately reflect the number of composite back-end screens that the Xdmx(1) server is using.

SEE ALSO

DMXGetScreenAttributes(3), DMXChangeScreensAttributes(3), DMX(3), Xdmx(1)