libinput/tools/libinput-analyze-touch-down-state.man
Peter Hutterer ff598741a9 tools: add a tool to analyze the finger count from a recording
Given a libinput recording, print the timestamps of any finger changes, i.e.
which slots are currently logically down. For example:

Timestamp | Rel time |     Slots     |
--------------------------------------
 0.000000 |  +0.000s | + |   |   |   |
 0.454631 |  +0.454s |   |   |   |   |
 5.065401 |  +4.610s | + |   |   |   |
 6.140281 |  +1.074s | + | + |   |   |
 7.410377 |  +1.270s |   | + |   |   |
 7.420200 |  +0.009s |   |   |   |   |
11.233108 |  +3.812s | + | + |   |   |
11.850206 |  +0.617s |   |   |   |   |
13.827740 |  +1.977s | + |   |   |   |
14.704027 |  +0.876s | + | + |   |   |
16.050577 |  +1.346s | + |   |   |   |
16.905186 |  +0.854s |   |   |   |   |

This data is available with the per-slot-delta tool but the output here is
more compressed, making it easier to detect stuck fingers. Pressure
thresholds are not currently supported.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2021-01-29 08:06:53 +10:00

45 lines
1.2 KiB
Groff

.TH libinput-analyze-touch-down-state "1"
.SH NAME
libinput\-analyze\-touch\-down\-state \- analyze the touch states
.SH SYNOPSIS
.B libinput analyze touch-down-state [\-\-help] [options] \fIrecording.yml\fI
.SH DESCRIPTION
.PP
The
.B "libinput analyze touch\-down\state"
tool analyzes a recording made with
.B "libinput record"
and prints "down" state of each touch. This tool aids with the detection of stuck touches.
.PP
This is a debugging tool only, its output may change at any time. Do not
rely on the output.
.SH OPTIONS
.TP 8
.B \-\-help
Print help
.TP 8
.B \-\-use-st
Use the single-touch BTN_TOOL_ bits instead of the slot state. The output
will only show the "highest" finger down at any time. For examples, where
two fingers are down, only the second slot will be marked as down.
.SH OUTPUT
An example output for a two-finger alternating sequence below.
.PP
.nf
.sf
6.140281 +1062ms: x | x
7.410377 +1257ms: | x
7.420200 +9ms: |
11.233108 +3812ms: x | x
11.245721 +12ms: x | x
11.850206 +604ms: |
13.827740 +1977ms: x |
13.839723 +11ms: x |
14.704027 +864ms: x | x
14.716691 +12ms: x | x
.fi
.in
.SH LIBINPUT
Part of the
.B libinput(1)
suite