aboutsummaryrefslogtreecommitdiff
path: root/xdeadzone.1
blob: 0e4a61dec8b00531138bde7b450ecbd2f8b5a101 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "XDEADZONE" 1 "2024-01-31" "0.1" "Urchlay's Misc Stuff"
.SH NAME
xdeadzone \- keep the mouse pointer out of the dead zone, on mismatched multihead displays.
.\" RST source for xdeadzone(1) man page. Convert with:
.
.\" rst2man.py xdeadzone.rst > xdeadzone.1
.
.SH SYNOPSIS
.sp
xdeadzone [\fB\-nw\fP | \fB\-ne\fP | \fB\-sw\fP | \fB\-se\fP | \fB\-abs\fP \fIx\-position\fP \fIy\-position\fP] \fIwidth\fP \fIheight\fP
.sp
xdeadzone \fB\-\-help\fP | \fB\-\-version\fP
.SH DESCRIPTION
.sp
xdeadzone\(aqs job is to create a window of a specified size, and prevent
the mouse pointer from entering it.
.sp
The intended use for it is to keep the mouse out of the "dead zone"
of a multi\-head X display where the monitors don\(aqt all have the same
resolution.
.sp
It could also be useful for covering annoying parts of the screen,
e.g. advertisements in ad\-driven software like the Opera browser, or
Adobe Reader.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-\-help
Print built\-in help message and exit.
.TP
.B  \-\-version
Print the application name and version number, and exit.
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-nw\fP
Place window at northwest (top left) corner of display.
.TP
.B \fB\-ne\fP
Place window at northeast (top right) corner of display.
.TP
.B \fB\-sw\fP
Place window at southwest (bottom left) corner of display.
.TP
.B \fB\-se\fP
Place window at southeast (bottom right) corner of display.
.TP
.B \fB\-abs\fP \fIx\-position\fP \fIy\-position\fP
Place window at the given coordinates. Negative numbers will be
treated as offsets from the right/bottom of the display.
.TP
.B \fBwidth\fP
Width of the dead zone. Required; must be a positive integer.
.TP
.B \fBheight\fP
Height of the dead zone. Required; must be a positive integer.
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.TP
.B \fBDISPLAY\fP
As usual for X applications: the X server to connect to.
.UNINDENT
.SH EXIT STATUS
.sp
With \fB\-\-help\fP or \fB\-\-version\fP, exit status is 0 (success).
.sp
If there\(aqs an error in the arguments, exit status is non\-zero (failure).
.sp
In normal operation, \fBxdeadzone\fP never exits.
.SH EXAMPLES
.sp
You have a 1920x1080 LCD monitor on the left, and a 1280x1024
one on the right. This gives you a nice 3200x1080 X display... but the
mouse can "vanish", because X pretends the right\-hand monitor has
1080 vertical pixels. So there\(aqs a 1280x56 horizontal strip "below" the
bottom of the right\-hand monitor that doesn\(aqt get displayed. If the
mouse moves into this area, the pointer disappears, and it\(aqs not
obvious what happened to it.
.sp
To avoid losing the pointer, you can run this:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
xdeadzone \-se 1280 56 &
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\&...from your ~/.xinitrc (or whatever you use to run commands at X startup).
.sp
If you instead have the same two monitors in a vertical arrangement,
with the 1280x1024 one on top, you\(aqll have a 640x1024 vertical strip
of \(aqdead zone\(aq beyond the right edge of the top monitor. To avoid
losing the mouse there:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
xdeadzone \-ne 640 1024 &
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
If the dead zone were on the left of the top monitor, you\(aqd use \fB\-nw\fP instead
of \fB\-ne\fP\&.
.SH BUGS
.sp
There isn\(aqt much error\-checking for the numeric arguments. Anything
non\-numeric will be read as zero. If you include a decimal point,
that should be an error, but instead it\(aqs silently ignored (the value
is truncated).
.sp
Maybe it should background (daemonize) itself. However, it works
fine with & to background it, and this is pretty common practice for
starting X software from ~/.xinitrc.
.SH COPYRIGHT
.sp
WTFPL. Do WTF you want to with this.
.sp
See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
.SH AUTHORS
.sp
\fBxdeadzone\fP was written by B. Watson (\fI\%urchlay@slackware.uk\fP).
.\" Generated by docutils manpage writer.
.