|
Packit |
ec660a |
.\" Copyright 2004 Red Hat Inc., Durham, North Carolina.
|
|
Packit |
ec660a |
.\" All Rights Reserved.
|
|
Packit |
ec660a |
.\"
|
|
Packit |
ec660a |
.\" Permission is hereby granted, free of charge, to any person obtaining
|
|
Packit |
ec660a |
.\" a copy of this software and associated documentation files (the
|
|
Packit |
ec660a |
.\" "Software"), to deal in the Software without restriction, including
|
|
Packit |
ec660a |
.\" without limitation on the rights to use, copy, modify, merge,
|
|
Packit |
ec660a |
.\" publish, distribute, sublicense, and/or sell copies of the Software,
|
|
Packit |
ec660a |
.\" and to permit persons to whom the Software is furnished to do so,
|
|
Packit |
ec660a |
.\" subject to the following conditions:
|
|
Packit |
ec660a |
.\"
|
|
Packit |
ec660a |
.\" he above copyright notice and this permission notice (including the
|
|
Packit |
ec660a |
.\" next paragraph) shall be included in all copies or substantial
|
|
Packit |
ec660a |
.\" portions of the Software.
|
|
Packit |
ec660a |
.\"
|
|
Packit |
ec660a |
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
Packit |
ec660a |
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
Packit |
ec660a |
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
Packit |
ec660a |
.\" NON-INFRINGEMENT. IN NO EVENT SHALL RED HAT AND/OR THEIR SUPPLIERS
|
|
Packit |
ec660a |
.\" BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
Packit |
ec660a |
.\" ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
Packit |
ec660a |
.\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
Packit |
ec660a |
.\" SOFTWARE.
|
|
Packit |
ec660a |
.TH DMXGetScreenAttributes __libmansuffix__ __vendorversion__
|
|
Packit |
ec660a |
.SH NAME
|
|
Packit |
ec660a |
DMXGetScreenAttributes \- determine back-end screen attributes
|
|
Packit |
ec660a |
.SH SYNOPSIS
|
|
Packit |
ec660a |
.B #include <X11/extensions/dmxext.h>
|
|
Packit |
ec660a |
.sp
|
|
Packit |
ec660a |
.nf
|
|
Packit |
ec660a |
.BI "Bool DMXGetScreenAttributes(Display " *dpy ,
|
|
Packit |
ec660a |
.BI " int " screen ,
|
|
Packit |
ec660a |
.BI " DMXScreenAttributes " *attr );
|
|
Packit |
ec660a |
.fi
|
|
Packit |
ec660a |
.SH DESCRIPTION
|
|
Packit |
ec660a |
.B DMXGetScreenAttributes()
|
|
Packit |
ec660a |
returns the attributes for the single DMX screen specified in
|
|
Packit |
ec660a |
.IR screen .
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
The
|
|
Packit |
ec660a |
.I DMXScreenAttributes
|
|
Packit |
ec660a |
structure is:
|
|
Packit |
ec660a |
.sp
|
|
Packit |
ec660a |
.nf
|
|
Packit |
ec660a |
typedef struct {
|
|
Packit |
ec660a |
char *displayName;
|
|
Packit |
ec660a |
int logicalScreen;
|
|
Packit |
ec660a |
|
|
Packit |
ec660a |
unsigned int screenWindowWidth;
|
|
Packit |
ec660a |
unsigned int screenWindowHeight;
|
|
Packit |
ec660a |
int screenWindowXoffset;
|
|
Packit |
ec660a |
int screenWindowYoffset;
|
|
Packit |
ec660a |
|
|
Packit |
ec660a |
unsigned int rootWindowWidth;
|
|
Packit |
ec660a |
unsigned int rootWindowHeight;
|
|
Packit |
ec660a |
int rootWindowXoffset;
|
|
Packit |
ec660a |
int rootWindowYoffset;
|
|
Packit |
ec660a |
|
|
Packit |
ec660a |
int rootWindowXorigin;
|
|
Packit |
ec660a |
int rootWindowYorigin;
|
|
Packit |
ec660a |
} DMXScreenAttributes;
|
|
Packit |
ec660a |
.fi
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
.I displayName
|
|
Packit |
ec660a |
is the name used to open the display, either from the
|
|
Packit |
ec660a |
.BR Xdmx (1)
|
|
Packit |
ec660a |
command-line or from the configuration file.
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
.I logicalScreen
|
|
Packit |
ec660a |
is the value of the screen that that
|
|
Packit |
ec660a |
.BR Xdmx (1)
|
|
Packit |
ec660a |
server exports to clients. When Xinerama is in use, this value is
|
|
Packit |
ec660a |
typically 0 for all values of physicalScreen. If Xinerama is in
|
|
Packit |
ec660a |
use,
|
|
Packit |
ec660a |
.I rootWindowXorigin
|
|
Packit |
ec660a |
and
|
|
Packit |
ec660a |
.I rootWindowYorigin
|
|
Packit |
ec660a |
specify where the physical screen is positioned in the global Xinerama
|
|
Packit |
ec660a |
coordinate system. Otherwise, these values are set to 0.
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
.IR screenWindowWidth ", " screenWindowHeight ", "
|
|
Packit |
ec660a |
.IR screenWindowXoffset ", and " screenWindowYoffset
|
|
Packit |
ec660a |
are a geometry specification (see
|
|
Packit |
ec660a |
.BR X (7x))
|
|
Packit |
ec660a |
for the location of the DMX screen on the back-end screen. The
|
|
Packit |
ec660a |
coordinate system of the back-end display is used for these values.
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
.IR rootWindowWidth ", " rootWindowHeight ", "
|
|
Packit |
ec660a |
.IR rootWindowXoffset ", and " rootWindowYoffset
|
|
Packit |
ec660a |
are a geometry specification (see
|
|
Packit |
ec660a |
.BR X (7x))
|
|
Packit |
ec660a |
for the location of the root window on the screen window. The
|
|
Packit |
ec660a |
coordinate system of the screen window is used. In most cases, the root
|
|
Packit |
ec660a |
window will have the same geometry as the DMX screen window, and will
|
|
Packit |
ec660a |
occupy the same area of the back-end display. (This would not be the
|
|
Packit |
ec660a |
case, for example, if automatic projector alignment is used.)
|
|
Packit |
ec660a |
.SH "RETURN VALUE"
|
|
Packit |
ec660a |
.B DMXGetScreenAttributes()
|
|
Packit |
ec660a |
returns
|
|
Packit |
ec660a |
.B True
|
|
Packit |
ec660a |
unless there is a protocol error.
|
|
Packit |
ec660a |
.PP
|
|
Packit |
ec660a |
.B DMXGetScreenAttributes()
|
|
Packit |
ec660a |
can generate
|
|
Packit |
ec660a |
.B BadValue
|
|
Packit |
ec660a |
errors.
|
|
Packit |
ec660a |
.SH "SEE ALSO"
|
|
Packit |
ec660a |
.BR DMXGetScreenCount "(__libmansuffix__), "
|
|
Packit |
ec660a |
.BR DMXChangeScreensAttributes "(__libmansuffix__), "
|
|
Packit |
ec660a |
.BR DMX "(__libmansuffix__), " Xdmx (1)
|