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