libinput/tools/libinput-analyze.man

41 lines
1 KiB
Groff
Raw Normal View History

.TH libinput-analyze "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
.SH NAME
libinput\-analyze \- analyze device data
.SH SYNOPSIS
.B libinput analyze [\-\-help] \fI<feature> [<args>]\fR
.SH DESCRIPTION
.PP
The
.B "libinput analyze"
tool analyzes device data. Depending on what is to
be analyzed, this tool may not create a libinput context.
.PP
This is a debugging tool only, its output may change at any time. Do not
rely on the output.
.PP
This tool may need to be run as root to have access to the
/dev/input/eventX nodes.
.SH OPTIONS
.TP 8
.B \-\-help
Print help
.SH FEATURES
Features that can be analyzed include
.TP 8
tools: add libinput analyze buttons for button state analysis This tool helps with tracking button states and time deltas between button events. Example output for a mouse with LMR buttons recorded (the mouse also has BTN_SIDE and BTN_EXTRA): Timestamp │ Delta │ L │ R │ M │ S │ E 0.596112 │ 0ms │ ┬ │ │ │ │ 0.689096 │ 92ms │ ┴ │ │ │ │ 1.129056 │ 439ms │ ┬ │ │ │ │ 1.308178 │ 179ms │ ┴ │ │ │ │ 1.469149 │ 0ms │ ┬ │ │ │ │ 1.598096 │ 128ms │ ┴ │ │ │ │ 1.862125 │ 264ms │ ┬ │ │ │ │ 2.084234 │ 222ms │ │ │ ┬ │ │ │ 2.415224 │ 330ms │ │ │ ┴ │ │ │ 2.831227 │ 416ms │ │ │ ┬ │ │ │ 3.215067 │ 383ms │ ┴ │ │ │ │ │ 3.525230 │ 310ms │ ┬ │ │ │ │ │ 3.629006 │ 103ms │ ┴ │ │ │ │ │ 3.813078 │ 184ms │ ┬ │ │ │ │ │ 3.909170 │ 96ms │ ┴ │ │ │ │ │ 4.093180 │ 184ms │ ┬ │ │ │ │ │ 4.317036 │ 223ms │ ┴ │ │ │ │ │ 4.507175 │ 190ms │ ┬ │ │ │ │ │ 4.587105 │ 79ms │ │ │ ┴ │ │ │ 4.779211 │ 192ms │ ┴ │ │ │ │ 5.075239 │ 296ms │ │ │ ┬ │ │ 5.259097 │ 183ms │ │ │ ┴ │ │ 5.379082 │ 119ms │ │ │ ┬ │ │ 5.483044 │ 103ms │ │ │ ┴ │ │ The default behavior is to highlight time deltas below 25ms in red. 25ms is our higher debounce timeout. Note that the delta time is the one between button events, ignoring any e.g. motion events in between. Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1010>
2024-06-12 10:05:54 +10:00
.B libinput\-analyze\-buttons(1)
analyze the button states of a recording
.TP 8
.B libinput\-analyze\-per-slot-delta(1)
analyze the delta per event per slot
.TP 8
.B libinput\-analyze\-recording(1)
analyze a recording made with
.B libinput\-record(1)
.TP 8
.B libinput\-analyze\-touch-down-state(1)
analyze the state of each touch in a recording
.SH LIBINPUT
Part of the
.B libinput(1)
suite