xqueryptr.c: Add new program to interrogate the pointer position.
[xtoys] / xqueryptr.1
CommitLineData
fc65327b
MW
1.\" -*-nroff-*-
2.TH xqueryptr 1 "18 March 2022" "Straylight/Edgeware" "xtoys"
3.SH NAME
4xqueryptr \- query pointer state
5.SH SYNOPSIS
6.B xqueryptr
7.RB [ \-d
8.IR display ]
9.SH DESCRIPTION
10The
11.B xqueryptr
12reports the current state of the pointing device as four integers:
13.I screen
14.I x
15.I y
16.IR mask .
17.PP
18The
19.I screen
20identifies which screen (in the technical X11 sense) the pointer is on
21in decimal, and is nowadays almost always 0;
22.I x
23and
24.I y
25give the pointer position relative to the top left corner of the screen
26in decimal; and
27.I mask
28gives the button and modifier state in hexadecimal.
29.SS Options
30.TP 5
31.BI "\-d, \-\-display " display
32Choose which display to connect to.
33.SH BUGS
34Hopefully none.
35.SH SEE ALSO
36.BR XQueryPointer (3x).
37.SH AUTHOR
38Mark Wooding (mdw@distorted.org.uk).