... |
... |
@@ -54,23 +54,29 @@ on the profiles and their behavior, see the libinput documentation. |
54
|
54
|
.BI "Option \*qAccelSpeed\*q \*q" float \*q
|
55
|
55
|
Sets the pointer acceleration speed within the range [-1, 1].
|
56
|
56
|
This only applies to the flat or adaptive profile.
|
57
|
|
-.BI "Option \*AccelPointsFallback\*q \*q" string \*q
|
58
|
|
-Sets the points of the Fallback acceleration function, (see the libinput documentation).
|
|
57
|
+.TP 7
|
|
58
|
+.BI "Option \*qAccelPointsFallback\*q \*q" string \*q
|
|
59
|
+.TQ
|
|
60
|
+.BI "Option \*qAccelPointsMotion\*q \*q" string \*q
|
|
61
|
+.TQ
|
|
62
|
+.BI "Option \*qAccelPointsScroll\*q \*q" string \*q
|
|
63
|
+Sets the points of the Fallback/Motion/Scroll acceleration functions.
|
59
|
64
|
The string must be a space-separated list of floating point non-negative numbers, e.g.
|
60
|
65
|
"0.0 1.0 2.4 2.5".
|
61
|
66
|
This only applies to the custom profile.
|
62
|
|
-.BI "Option \*AccelStepFallback\*q \*q" float \*q
|
63
|
|
-Sets the step between the points of the Fallback acceleration function, (see the libinput documentation).
|
64
|
|
-When a step of 0.0 is provided, libinput's default Fallback acceleration function is used.
|
|
67
|
+See section
|
|
68
|
+.B CUSTOM ACCELERATION PROFILE
|
|
69
|
+.TP 7
|
|
70
|
+.BI "Option \*qAccelStepFallback\*q \*q" float \*q
|
|
71
|
+.TQ
|
|
72
|
+.BI "Option \*qAccelStepMotion\*q \*q" float \*q
|
|
73
|
+.TQ
|
|
74
|
+.BI "Option \*qAccelStepScroll\*q \*q" float \*q
|
|
75
|
+Sets the step between the points of the Fallback/Motion/Scroll acceleration functions.
|
|
76
|
+When a step of 0.0 is provided, libinput's Fallback acceleration function is used.
|
65
|
77
|
This only applies to the custom profile.
|
66
|
|
-.BI "Option \*AccelPointsMotion\*q \*q" string \*q
|
67
|
|
-Equivalent to AccelPointsFallback but applies to the Motion acceleration function.
|
68
|
|
-.BI "Option \*AccelStepMotion\*q \*q" float \*q
|
69
|
|
-Equivalent to AccelStepFallback but applies to the Motion acceleration function.
|
70
|
|
-.BI "Option \*AccelPointsScroll\*q \*q" string \*q
|
71
|
|
-Equivalent to AccelPointsFallback but applies to the Scroll acceleration function.
|
72
|
|
-.BI "Option \*AccelStepScroll\*q \*q" float \*q
|
73
|
|
-Equivalent to AccelStepFallback but applies to the Scroll acceleration function.
|
|
78
|
+See section
|
|
79
|
+.B CUSTOM ACCELERATION PROFILE
|
74
|
80
|
.TP 7
|
75
|
81
|
.BI "Option \*qButtonMapping\*q \*q" string \*q
|
76
|
82
|
Sets the logical button mapping for this device, see
|
... |
... |
@@ -247,15 +253,41 @@ on the device. The following properties are provided by the |
247
|
253
|
driver.
|
248
|
254
|
.TP 7
|
249
|
255
|
.BI "libinput Accel Profiles Available"
|
250
|
|
-2 boolean values (8 bit, 0 or 1), in order "adaptive", "flat".
|
|
256
|
+3 boolean values (8 bit, 0 or 1), in order "adaptive", "flat", "custom".
|
251
|
257
|
Indicates which acceleration profiles are available on this device.
|
252
|
258
|
.TP 7
|
253
|
259
|
.BI "libinput Accel Profile Enabled"
|
254
|
|
-2 boolean values (8 bit, 0 or 1), in order "adaptive", "flat".
|
|
260
|
+3 boolean values (8 bit, 0 or 1), in order "adaptive", "flat", "custom".
|
255
|
261
|
Indicates which acceleration profile is currently enabled on this device.
|
256
|
262
|
.TP 7
|
257
|
263
|
.BI "libinput Accel Speed"
|
258
|
|
-1 32-bit float value, defines the pointer speed. Value range -1, 1
|
|
264
|
+1 32-bit float value, defines the pointer speed. Value range -1, 1.
|
|
265
|
+This only applies to the flat or adaptive profile.
|
|
266
|
+.TP 7
|
|
267
|
+.BI "libinput Accel Custom Fallback Points"
|
|
268
|
+.TQ
|
|
269
|
+.BI "libinput Accel Custom Motion Points"
|
|
270
|
+.TQ
|
|
271
|
+.BI "libinput Accel Custom Scroll Points"
|
|
272
|
+A space-separated list of 32-bit floating point non-negative numbers, e.g.
|
|
273
|
+"0.0 1.0 2.4 2.5".
|
|
274
|
+Sets the points of the Fallback/Motion/Scroll acceleration functions.
|
|
275
|
+This only applies to the custom profile.
|
|
276
|
+See section
|
|
277
|
+.B CUSTOM ACCELERATION PROFILE
|
|
278
|
+.TP 7
|
|
279
|
+.BI "libinput Accel Custom Fallback Step"
|
|
280
|
+.TQ
|
|
281
|
+.BI "libinput Accel Custom Motion Step"
|
|
282
|
+.TQ
|
|
283
|
+.BI "libinput Accel Custom Scroll Step"
|
|
284
|
+1 32-bit float value, sets the step between the points of the
|
|
285
|
+Fallback/Motion/Scroll acceleration functions.
|
|
286
|
+When a step of 0.0 is provided, libinput's Fallback acceleration
|
|
287
|
+function is used.
|
|
288
|
+This only applies to the custom profile.
|
|
289
|
+See section
|
|
290
|
+.B CUSTOM ACCELERATION PROFILE
|
259
|
291
|
.TP 7
|
260
|
292
|
.BI "libinput Button Scrolling Button"
|
261
|
293
|
1 32-bit value. Sets the button number to use for button scrolling. This
|
... |
... |
@@ -449,6 +481,35 @@ libinput provides scroll data in pixels. The \fBScrollPixelDistance\fR |
449
|
481
|
option defines the amount of movement equivalent to one wheel click. For
|
450
|
482
|
example, a value of 50 means the user has to move a finger by 50 pixels to
|
451
|
483
|
generate one logical click event and each pixel is 1/50th of a wheel click.
|
|
484
|
+
|
|
485
|
+.SH CUSTOM ACCELERATION PROFILE
|
|
486
|
+The custom pointer acceleration profile gives users full control over the
|
|
487
|
+acceleration behavior at different speeds. libinput exposes an acceleration
|
|
488
|
+function f(x) where the x-axis is the device speed in device units per millisecond
|
|
489
|
+and the y-axis is the pointer speed.
|
|
490
|
+.PP
|
|
491
|
+The custom acceleration function is defined using n points which are spaced
|
|
492
|
+uniformly along the x-axis, starting from 0 and continuing in constant steps.
|
|
493
|
+Thus the points defining the custom function are:
|
|
494
|
+.EX
|
|
495
|
+(0 * step, f[0]), (1 * step, f[1]), ..., ((n-1) * step, f[n-1])
|
|
496
|
+.EE
|
|
497
|
+When a velocity value does not lie exactly on those points,
|
|
498
|
+a linear interpolation/extrapolation of the two closest points will be calculated.
|
|
499
|
+.PP
|
|
500
|
+There are 3 custom acceleration function, which are used for different movement types:
|
|
501
|
+.TS
|
|
502
|
+tab(;) allbox;
|
|
503
|
+l l l.
|
|
504
|
+Movement type; Uses; supported by
|
|
505
|
+Fallback; Catch-all default movement type; All devices
|
|
506
|
+Motion; Used for pointer motion; All devices
|
|
507
|
+Scroll; Used for scroll movement; Mouse, Touchpad
|
|
508
|
+.TE
|
|
509
|
+.PP
|
|
510
|
+See libinput library documentation of more details:
|
|
511
|
+https://wayland.freedesktop.org/libinput/doc/latest/pointer-acceleration.html#the-custom-acceleration-profile
|
|
512
|
+
|
452
|
513
|
.SH BUGS
|
453
|
514
|
This driver does not work with \fBOption \*qDevice\*q\fR set to an event
|
454
|
515
|
node in \fI/dev/input/by-id\fR and \fI/dev/input/by-path\fR. This can be
|