mirror of
https://gitlab.freedesktop.org/libinput/libinput.git
synced 2025-12-24 15:50:07 +01:00
d8bd650540
This adds a third profile to the available profiles to map device-specific speed to an acceleration factor, fully defined by the caller. There has been a consistent call for different acceleration profiles in libinput, but very little specifics in what actually needs to be changed. "faster horses" and whatnot (some notable exceptions in e.g. bug 101139). Attempts to change the actual acceleration function will likely break things for others. This approach opens up the profile itself to a user-specific acceleration curve. A caller can set an acceleration curve by defining a number of points on that curve to map input speed to an output factor. That factor is applied to the input delta. libinput does relatively little besides mapping the deltas to the device-specific speed, querying the curve for that speed and applying that factor. The curve is device-specific, the input speed is in device units/ms. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
101 lines
3.3 KiB
Groff
101 lines
3.3 KiB
Groff
.TH libinput-debug-events "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
|
|
.SH NAME
|
|
libinput\-debug\-events \- debug helper for libinput
|
|
.SH SYNOPSIS
|
|
.B libinput debug\-events [\-\-help] [\-\-show\-keycodes] [\-\-udev \fI<seat>\fB|\-\-device \fI/dev/input/event0\fB] \fI[configuration options]\fB
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The
|
|
.B "libinput debug\-events"
|
|
tool creates a libinput context and prints all events from these devices.
|
|
.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
|
|
.TP 8
|
|
.B \-\-device \fI/dev/input/event0\fR
|
|
Use the given device with the path backend
|
|
.TP 8
|
|
.B \-\-grab
|
|
Exclusively grab all opened devices. This will prevent events from being
|
|
delivered to the host system.
|
|
.TP 8
|
|
.B \-\-help
|
|
Print help
|
|
.TP 8
|
|
.B \-\-quiet
|
|
Only print libinput messages, don't print anything from this tool. This is
|
|
useful in combination with --verbose for internal state debugging.
|
|
.TP 8
|
|
.B \-\-show\-keycodes
|
|
Key events shown by this tool are partially obfuscated to avoid passwords
|
|
and other sensitive information showing up in the output. Use the
|
|
.B \-\-show\-keycodes
|
|
argument to make all keycodes visible.
|
|
.TP 8
|
|
.B \-\-udev \fI<seat>\fR
|
|
Use the udev backend to listen for device notifications on the given seat.
|
|
The default behavior is equivalent to \-\-udev "seat0".
|
|
.TP 8
|
|
.B \-\-verbose
|
|
Use verbose output
|
|
.SS libinput configuration options
|
|
.TP 8
|
|
.B \-\-disable-sendevents="pattern"
|
|
Set the send-events option to disabled for the devices matching patterns.
|
|
.TP 8
|
|
.B \-\-enable\-tap|\-\-disable\-tap
|
|
Enable or disable tap-to-click
|
|
.TP 8
|
|
.B \-\-enable-drag|\-\-disable\-drag
|
|
Enable or disable tap-and-drag
|
|
.TP 8
|
|
.B \-\-enable\-drag-lock|\-\-disable\-drag\-lock
|
|
Enable or disable tap-and-drag
|
|
.TP 8
|
|
.B \-\-enable\-natural\-scrolling|\-\-disable\-natural\-scrolling
|
|
Enable or disable natural scrolling
|
|
.TP 8
|
|
.B \-\-enable\-left\-handed|\-\-disable\-left\-handed
|
|
Enable or disable left handed button configuration
|
|
.TP 8
|
|
.B \-\-enable\-middlebutton|\-\-disable\-middlebutton
|
|
Enable or disable middle button emulation
|
|
.TP 8
|
|
.B \-\-enable\-dwt|\-\-disable\-dwt
|
|
Enable or disable disable-while-typing
|
|
.TP 8
|
|
.B \-\-set\-accel-curve-points="x1:y1;x2:y2"
|
|
Sets the curve points for the \fIcustom-speed\fR acceleration profile. The
|
|
set of curve points is a semicolon-separate lists of key-value pairs, each
|
|
separated by a colon. Each value is a non-negative double.
|
|
.TP 8
|
|
.B \-\-set\-click\-method=[none|clickfinger|buttonareas]
|
|
Set the desired click method
|
|
.TP 8
|
|
.B \-\-set\-scroll\-method=[none|twofinger|edge|button]
|
|
Set the desired scroll method
|
|
.TP 8
|
|
.B \-\-set\-scroll\-button=BTN_MIDDLE
|
|
Set the button to the given button code
|
|
.TP 8
|
|
.B \-\-set\-profile=[adaptive|flat|custom-speed]
|
|
Set pointer acceleration profile. If the \fIcustom-speed\fR profile is
|
|
selected, use \fB\-\-set-accel-curve-points\fR to specify the curve points.
|
|
.TP 8
|
|
.B \-\-set\-speed=<value>
|
|
Set pointer acceleration speed. The allowed range is [-1, 1].
|
|
.TP 8
|
|
.B \-\-set\-tap\-map=[lrm|lmr]
|
|
Set button mapping for tapping
|
|
.SH NOTES
|
|
.PP
|
|
Events shown by this tool may not correspond to the events seen by a
|
|
different user of libinput. This tool initializes a separate context.
|
|
.SH LIBINPUT
|
|
Part of the
|
|
.B libinput(1)
|
|
suite
|