libinput/tools/libinput-analyze-buttons.man

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

27 lines
619 B
Groff
Raw Normal View History

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
.TH libinput-analyze-buttons "1"
.SH NAME
libinput\-analyze\-buttons \- analyze the button states of a recording
.SH SYNOPSIS
.B libinput analyze buttons [\-\-help] [options] \fIrecording.yml\fI
.SH DESCRIPTION
.PP
The
.B "libinput analyze buttons"
tool analyzes a recording made with
.B "libinput record"
and prints information about the button states.
.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 \-\-threshold=<ms>
Color any delta time less than the threshold in red.
.SH LIBINPUT
Part of the
.B libinput(1)
suite