libinput-measure-touchpad-tap.man 2.76 KB
Newer Older
1
.TH libinput-measure-touchpad-tap "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
2
.SH NAME
3
libinput\-measure\-touchpad\-tap \- measure tap-to-click properities of devices
4
.SH SYNOPSIS
5
.B libinput measure touchpad\-tap [\-\-help] [\-\-format=\fI<format>\fB] \fI[/dev/input/event0]\fR
6 7 8
.SH DESCRIPTION
.PP
The
9 10
.B "libinput measure touchpad\-tap"
tool measures properties of the tap\-to\-click behavior of the user. This is
11 12
an interactive tool. When executed, the tool will prompt the user to
interact with the touchpad. On termination, the tool prints a summary of the
13
tap interactions seen. This data should be attached to any tap\-related bug
14 15 16 17 18 19 20 21 22 23 24 25
report.
.PP
For a full description on how libinput's tap-to-click behavior works, see
the online documentation here:
.I https://wayland.freedesktop.org/libinput/doc/latest/tapping.html
.PP
This is a debugging tool only, its output may change at any time. Do not
rely on the output.
.PP
This tool usually needs to be run as root to have access to the
/dev/input/eventX nodes.
.SH OPTIONS
26 27 28
If a device node is given, this tool opens that device node. Otherwise, this
tool searches for the first node that looks like a touchpad and uses that
node.
29
.TP 8
30
.B \-\-help
31 32
Print help
.TP 8
33
.B \-\-format=summary|dat
34
Specify the data format to be printed. The default (or if
35
.B \-\-format
36 37 38 39 40
is omitted) is "summary". See section
.B DATA FORMATS

.SH DATA FORMATS
This section describes the data formats printed with the
41
.B \-\-format
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
commandline argument. Note that any of the output may change at any time.
.RE
.PP
summary
.RS 4
The
.I summary
format prints a summary of the data collected. This format is useful to
get a quick overview of a user's tapping behavior and why some taps may or
may not be detected.
.RE
.PP
dat
.RS 4
The
.I dat
format prints the touch sequence data (raw and processed) in column-style
format, suitable for processing by other tools such as
.B gnuplot(1).
The data is aligned in one row per touch with each column containing a
separate data entry.
63
.B libinput\-measure\-touchpad\-tap
64 65 66 67 68 69 70 71 72
prints comments at the top of the file to describe each column.
.PP
.B WARNING:
The data contained in the output is grouped by different sort orders. For
example, the first few columns may list tap information in the 'natural'
sort order (i.e. as they occured), the data in the next few columns may list
tap information sorted by the delta time between touch down and touch up.
Comparing columns across these group boundaries will compare data of two
different touch points and result in invalid analysis.
73 74 75 76
.SH BUGS
This tool does not take finger pressure into account. The tap it detects may
be different to those detected by libinput if libinput's pressure thresholds
differ significantly to the kernel's pressure thresholds.
77 78 79 80
.SH LIBINPUT
Part of the
.B libinput(1)
suite